Isuzu Unity CLI

isuzu-unity-cli

Each command talks to the Unity Editor that has this project open and prints compact JSON. A call returns when its work is done: play_mode_play returns once play mode has started, and a call that takes long waits for its result.

Rules

• Do not list tools. The table below covers common work; for anything else run isuzu-unity-cli tools --search <words>, then isuzu-unity-cli tools <name>.
• Put every call you already know into one shell command with the template below. Do not read again to confirm a change: each reply already shows the result, and you can answer from it.
• Windows PowerShell deletes double quotes inside arguments, so never pass JSON text. Use --name value; repeat an option for a list (--paths a --paths b); --values.m_Mass 2 sets one field of an object argument; a vector is --position '1,0,2'; anything else goes in a file: --args-file args.json.
• Single-quote values with spaces, commas or @: '/Main Camera', 'error,warning', '@scene:/Boss/Enemy/health'. Unquoted, PowerShell splits 1,0,2 into three words.
• Scene paths start with /. Siblings that share a name take a 0-based index: /Audio/Speaker[1].
• Property paths are serialized names (m_Mass, m_LocalPosition.x, a script's field name); the C# name (mass) also works when it is unambiguous, and a miss lists the nearest names.

Template

function u { isuzu-unity-cli @args; if ($LASTEXITCODE) { throw "isuzu-unity-cli $args failed ($LASTEXITCODE)" } }
try {
  u call play_mode_play
  u call ui_click --text Start
} finally { isuzu-unity-cli call play_mode_stop }

A failed call throws, so the calls after it do not run on a broken state, and finally leaves play mode. Without play mode, the try/finally is not needed.

Tasks

execute_code

@'
return McpSnippet.All<Light>(true)
    .Where(l => l.enabled && l.gameObject.activeInHierarchy)
    .Select(l => McpSnippet.PathOf(l.gameObject));
'@ | Set-Content -Encoding UTF8 $env:TEMP\snippet.cs
u call execute_code --file $env:TEMP\snippet.cs

Why a camera does not draw an object (replace the two paths):

@'
var cam = McpSnippet.Find("/Main Camera").GetComponent<Camera>();
var r = McpSnippet.Find("/Path/To/Object").GetComponentInChildren<Renderer>(true);
return new { cameraObjectActive = cam.gameObject.activeInHierarchy, cameraEnabled = cam.enabled, cam.targetTexture, cam.cullingMask, r.gameObject.layer, layerInMask = (cam.cullingMask & (1 << r.gameObject.layer)) != 0,
    objectActive = r.gameObject.activeInHierarchy, rendererEnabled = r.enabled, material = r.sharedMaterial ? r.sharedMaterial.name : null,
    cam.nearClipPlane, cam.farClipPlane, depth = cam.transform.InverseTransformPoint(r.bounds.center).z, halfDepth = r.bounds.extents.z,
    inFrustum = GeometryUtility.TestPlanesAABB(GeometryUtility.CalculateFrustumPlanes(cam), r.bounds) };
'@ | Set-Content -Encoding UTF8 $env:TEMP\visible.cs
u call execute_code --file $env:TEMP\visible.cs

• Statements with return <value>. System, System.Linq, UnityEngine, UnityEditor and both SceneManagement namespaces are imported. McpSnippet has PathOf(go), Find(path), IdOf(obj) and All<T>(includeInactive).
• Record scene edits with Undo.RegisterCreatedObjectUndo or Undo.RecordObject, then save with u call scene_save rather than inside the snippet.
• A compile error names the line and column in your snippet.

Waiting for Unity

Do not write a wait loop of your own. A request sent to the Editor's port by hand is refused without its token, health always has a dialog key (null when there is none), and the shared Editor.log belongs to whichever Editor started last.

When a call fails

More: reference/tools.md (tools by area), reference/workflows.md (dialogs, a stuck Editor, input recording).