Release v4.4.2

日本語

• shader_errors の応答から各メッセージのコンパイル時の詳細を省き、どの変種で出たかを pass で示すようにしました。全文は include_details で取得できます。
• ジョブになった呼び出しの応答と MCP の instructions に、isuzu-unity-cli jobs <id> --wait で完了を待てることを書くようにしました。同梱のスキルにも待ち方の一覧を足しました。
• capture_screenshot が、シェーダーのコンパイル中は終わるのを待ってから撮るようにしました。コンパイル中の変種はシアンの仮表示で描かれるためです。
• 呼び出しの途中で Editor が終了したとき、またはサーバーが止められたときに、ドメインのリロードではなく editor_exited を返すようにしました。

English

• shader_errors leaves out each message's compile context and names the variant in pass; include_details returns the full context.
• A call that turns into a job, and the MCP instructions, now name isuzu-unity-cli jobs <id> --wait as the way to wait for it. The bundled skill lists how to wait for a job, a compile, an import and Package Manager.
• capture_screenshot waits while shaders are compiling, because a variant still compiling draws as a cyan placeholder.
• An Editor that closes, or whose server is stopped, while answering a call is reported as editor_exited instead of a domain reload.

What's Changed

Other Changes

• 4.4.2: smaller shader_errors replies, captures that wait for shaders, and a way to wait for a job by @isuzu-shiranui in #49

Full Changelog: v4.4.1...v4.4.2

Release v4.4.1

日本語

• execute_code の戻り値に Color や Vector3 などの Unity の型を含めても、Editor がクラッシュしないようにしました。
• 呼び出し中に Editor が終了したとき、CLI がドメインのリロード中と伝えるのではなく、Editor の終了（editor_exited）を伝えるようにしました。

English

• execute_code no longer crashes the Editor when its return value contains Unity types such as Color or Vector3.
• When the Editor closes during a call, the CLI now reports editor_exited instead of treating it as a domain reload.

What's Changed

Other Changes

• 4.4.1: execute_code no longer crashes the Editor on a Color, and the CLI says when the Editor has closed by @isuzu-shiranui in #48

Full Changelog: v4.4.0...v4.4.1

Release v4.4.0

What's Changed

Other Changes

• 4.4.0: an agent finishes a task in fewer round trips by @isuzu-shiranui in #47

Full Changelog: v4.3.3...v4.4.0

Release v4.3.3

What's Changed

Other Changes

• fix: the install one-liner fails in the console it is meant for by @isuzu-shiranui in #44
• 4.3.3: a partial hierarchy read says what it left out by @isuzu-shiranui in #46

Full Changelog: v4.3.2...v4.3.3

Release v4.3.2

4.3.2

コマンドの接続先を、最初に選んだプロジェクトに固定するリリースです。対象の Editor が見つからなくなったときは、別の Editor に送らず、理由を出力して終了します。

更新の手順

4.3.x から

isuzu-unity-cli update

CLI を更新してから、開いている Editor のパッケージを 4.3.2 に更新します。CLI の更新に失敗した場合、パッケージは更新しません。

4.2.0 から

4.2.0 の CLI には update がありません。4.3.0 で追加したものです。先に CLI を更新してください。

isuzu-unity-cli upgrade      # CLI を 4.3.2 に更新する
isuzu-unity-cli doctor --fix # エージェント用スキルを 4.3.2 のものに更新する
isuzu-unity-cli update       # 各プロジェクトのパッケージを 4.3.2 に更新する

doctor --fix が必要なのは、4.2.0 の upgrade が、更新前の実行ファイルのままスキルを検証するためです。4.3.2 以降の upgrade は更新後の実行ファイルで検証するので、この手順は要りません。

パッケージだけを更新する場合は、Package Manager で Git URL に #v4.3.2 を付けて入れ直すか、VCC / ALCOM で 4.3.2 を選んでください。

4.3.0 に、MCP クライアントから見える変更がいくつかあります。

• 応答がツールの上限を超えた場合、内容を送らずに isError を返します。
• 応答から structuredContent を削除しました。同じ JSON がテキストに入っています。
• capture_screenshot、reflect_read、gpu_readback から読み取り専用の注釈を外しました。名前に反して副作用があるためです。reflect_read は getter を実行するので、Renderer.material を読むと共有マテリアルの複製ができます。capture_screenshot はウィンドウを手前に出し、gpu_readback は転送が終わるまでメインスレッドを止めます。読み取り専用と宣言している間、クライアントはこれらを確認なしに実行し、勝手に再試行することがありました。
• ツールが宣言していない引数は、無視せずにエラーを返します。
• asset_export_package の保存先の引数名が file から destination に変わりました。
• console_read_logs は、stack_trace を指定しない限りスタックトレースを返しません。
• CLI は、未定義のオプションと値の無いオプションを終了コード 2 で拒否します。同じオプションを 2 回指定した場合は配列として送ります。

4.1.x 以前から

手順は 4.2.0 からと同じです。上に加えて、4.2.0 と 4.1.0 の変更が適用されます。

• project_assemblies の戻り値から fullName を削除しました。
• scene_browse_hierarchy のノードは id を返さず、既定値のキーを省きます。
• CLI は、出力をパイプやリダイレクトに渡すとき JSON を整形しません。

v3 から

CLI の名前もインストール方法も変わっています。v3 からの移行を参照してください。

主な変更

• verify、jobs --wait、mcp-stdio は、最初に選んだプロジェクトのパスを開いている Editor にだけ再接続します。そのパスを開いている Editor がちょうど 1 つでないときは、理由と切り替え方を出力して終了します。どの Editor も開いていない Unity プロジェクトの中で実行したコマンドは、たまたま起動している別のプロジェクトの Editor に送らず、終了コード 3 で終了します。
• verify --test が、失敗したテストや結論の出なかったテスト（Inconclusive）が Editor の 200 件の上限より後ろにあるとき、成功と報告していた不具合を修正しました。
• update は、パッケージを更新する前に CLI を更新します。更新に失敗したバージョンが manifest に書かれることはなくなりました。最新リリースの確認も、更新通知用の 6 時間キャッシュを使わず、GitHub に問い合わせます。
• 名前に / を含む GameObject や、[数字] で終わる GameObject を、階層パスから正しく解決できるようになりました。ui_hit_test と asset_broken_references も同じ形式でパスを返します。
• 入力の検証を次のように直しました。
  • Transform の入力（position、rotation、scale）は、3 つとも検証してから反映します。
  • prefab_create は、Unity が未インポートのファイルを上書きしません。
  • scene_create にフォルダーのパスを渡した場合、開いているシーンに触れる前にエラーを返します。
  • render_capture_ab を実行中に再度呼び出した場合、エラーを返します。
• 手動で停止したサーバーが、ドメインリロードのあとに自動で起動しなくなりました。Settings の Register を押している間 Editor が応答しなくなることもなくなり、CLI の行に再確認のボタンが付きました。
• MCP では、job_status が返す結果にも、そのジョブを実行したツールの上限が適用されます。
• リリースが server.json を MCP レジストリに公開するようになりました。

すべての変更は CHANGELOG にあります。

謝辞

@meiiie さんに感謝します。再接続をプロジェクトのパスに固定する最初の修正（#42）と、テスト結果の集計の修正（#41）は、どちらもこの方によるものです。4.3.0 のベトナム語対応（#34）も同じ方です。

---

What's Changed

Other Changes

• 4.3.2: every reconnect stays with the project it selected by @isuzu-shiranui in #43

Full Changelog: v4.3.1...v4.3.2

Release v4.3.1

What's Changed

Other Changes

• fix: the Windows installer says why it could not verify a download by @isuzu-shiranui in #39
• 4.3.1: a CLI installed with winget is left to winget by @isuzu-shiranui in #40

Full Changelog: v4.3.0...v4.3.1

Release v4.3.0

4.2.0 からのアップデート方法

CLI と Unity パッケージは同じバージョンで公開しています。4.2.0 の CLI には update コマンドが無いので、まず CLI を上げてから、その CLI でパッケージを上げます。

1. CLI を 4.3.0 にする

isuzu-unity-cli upgrade

dotnet tool で入れた場合は dotnet tool update -g IsuzuUnityCli を、Claude Desktop の拡張（.mcpb）で入れた場合は、このリリースの isuzu-unity-cli.mcpb を入れ直してください。

2. Unity パッケージを 4.3.0 にする

Unity でプロジェクトを開いたまま実行します。

isuzu-unity-cli update --dry-run
isuzu-unity-cli update

Git URL で入れたプロジェクトは、Packages/manifest.json の依存が #v4.3.0 付きに書き換わり、Unity の Editor に戻ると取り込まれます。Package Manager の Add package from git URL に https://github.com/isuzu-shiranui/UnityMCP.git?path=jp.shiranui-isuzu.unity-mcp#v4.3.0 を入れ直しても同じです。

VCC / ALCOM で入れたプロジェクトは、update では書き換えません。VCC または ALCOM で 4.3.0 に更新してください。Packages/ にフォルダーとして置いた場合は、中身をこのリリースの jp.shiranui-isuzu.unity-mcp-4.3.0.zip に置き換えてください。

3. スキルを入れ替え、MCP クライアントをつなぎ直す

isuzu-unity-cli setup

Claude Code と Codex 向けのスキルが 4.3.0 の内容に入れ替わります。MCP の登録には触れません。MCP クライアントは、つなぎ直すと増えたツールが一覧に出ます。

4. そろったことを確認する

isuzu-unity-cli doctor

次からは isuzu-unity-cli update だけで、CLI とパッケージをまとめて更新できます。互換性に関わる変更は、CHANGELOG の 4.3.0 の Breaking にまとめています。

---

Updating from 4.2.0

The CLI and the Unity package are released under one version. A 4.2.0 CLI has no update command, so update the CLI first and then use it to update the package.

1. Update the CLI to 4.3.0

isuzu-unity-cli upgrade

If you installed it as a dotnet tool, run dotnet tool update -g IsuzuUnityCli instead. If you installed it as a Claude Desktop extension (.mcpb), install isuzu-unity-cli.mcpb from this release again.

2. Update the Unity package to 4.3.0

Run this with the project open in Unity.

isuzu-unity-cli update --dry-run
isuzu-unity-cli update

For a project that installed the package through a Git URL, the dependency in Packages/manifest.json is rewritten to end in #v4.3.0, and Unity picks it up when you return to the Editor. Adding https://github.com/isuzu-shiranui/UnityMCP.git?path=jp.shiranui-isuzu.unity-mcp#v4.3.0 again through Add package from git URL in the Package Manager does the same.

update does not rewrite a project that installed the package through VCC or ALCOM; update it to 4.3.0 there. If the package is a folder under Packages/, replace its contents with jp.shiranui-isuzu.unity-mcp-4.3.0.zip from this release.

3. Replace the skill and reconnect MCP clients

isuzu-unity-cli setup

This replaces the skill for Claude Code and Codex with the 4.3.0 one and leaves MCP registrations as they are. Reconnect your MCP client to see the new tools.

4. Check that the versions match

isuzu-unity-cli doctor

From now on, isuzu-unity-cli update alone updates the CLI and the package together. Breaking changes are listed under Breaking in 4.3.0 in the CHANGELOG.

---

What's Changed

Other Changes

• 4.3.0: twenty tools, the two halves updated together, and Vietnamese by @isuzu-shiranui in #37

Full Changelog: v4.2.0...v4.3.0

Release v4.2.0

What's Changed

Other Changes

• fix: arguments the caller sets and the handler then ignores by @isuzu-shiranui in #33

Full Changelog: v4.1.1...v4.2.0

Release v4.1.1

What's Changed

Other Changes

• Publish under the domain rather than the GitHub account by @isuzu-shiranui in #32

Full Changelog: v4.1.0...v4.1.1

Release v4.1.0

What's Changed

Other Changes

• A hierarchy read that costs a fifth, and one that costs nothing twice by @isuzu-shiranui in #31

Full Changelog: v4.0.6...v4.1.0