메뉴
Use when building, running headless, or running tests for a Unity project from the command line.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when interacting with a running Unity Editor instance — sending commands, checking editor connection status, installing the Pipeline package, or evaluating C# expressions in the editor.
Use when installing, uninstalling, or upgrading Unity editors, adding or listing modules, or browsing available Unity releases.
Use for general Unity CLI operations — list or open projects, list installed editors, read CLI logs, or any other Unity CLI task not covered by a more specific skill (unity-cli-install, unity-cli-build, unity-cli-pipeline).
Use when creating or editing Unity Shader Graph assets programmatically (Unity 6.5+) — authoring custom nodes from HLSL via the Shader Function Reflection API, generating .shadergraph files, or wiring nodes by editing the graph JSON.
Use when reading the Unity Editor Console (log/warning/error entries) or detecting compile errors (C#/Burst, shader, compute shader) from a connected editor via the Pipeline package.
Use when creating a new minimal Unity project.
| name | unity-cli-build |
| description | Use when building, running headless, or running tests for a Unity project from the command line. |
| allowed-tools | ["Bash"] |
Use --format json when parsing output programmatically.
Batch mode is automatic. Do not pass -batchmode or -quit after --.
unity run /path/to/MyProject -- -executeMethod Builder.Build
unity run /path/to/MyProject --editor-version 6000.0.47f1 -- -nographics -logFile out.log
unity run /path/to/MyProject --allow-install -- -executeMethod Builder.Build
unity run /path/to/MyProject --timeout 300 -- -executeMethod Builder.Build
Reserved flags (added automatically, rejected if passed): -batchmode, -quit, -projectPath, -useHub, -hubIPC.
Writes an NUnit XML report. Exits 0 on pass, 6 on failure.
unity test /path/to/MyProject
unity test /path/to/MyProject --mode EditMode
unity test /path/to/MyProject --mode PlayMode --output ./results/play.xml
unity test /path/to/MyProject --filter "MyNamespace.MyTests"
unity test /path/to/MyProject --editor-version 6000.0.47f1 --allow-install --timeout 600
unity test /path/to/MyProject -- -nographics
Default output: test-results.xml. Do not pass -quit — -runTests quits the editor itself.
Both --target and --execute-method are required. Unity has no built-in CLI build; your method handles the actual build logic.
unity build /path/to/MyProject \
--target StandaloneOSX \
--execute-method Builder.PerformBuild \
--output-path ./build/output
Common targets: StandaloneOSX, StandaloneWindows64, StandaloneLinux64, Android, iOS, WebGL.
| Flag | Description |
|---|---|
--target <target> | Build target (required) |
--execute-method <method> | Static C# method to invoke (required) |
-o, --output-path <path> | Passed as -buildOutput |
-l, --log-file <path> | Log file (default: <project>/Logs/build-<target>-<timestamp>.log) |
--editor-version <version> | Override editor version |
--allow-install | Install editor if missing |
--allow-dirty-build | Skip uncommitted-changes guard |
--no-tail | Do not stream log to stdout |
Android signing (optional): --android-export-type apk|aab|android-studio-project, --android-keystore-base64, --android-keystore-password, --android-key-alias, --android-key-alias-password.