菜单
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).
用 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 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.
Operational style guide for Jujutsu (jj) VCS. Use when working with version control in a project that has a .jj directory.
| name | unity-cli |
| description | 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). |
| allowed-tools | ["Bash"] |
Use --format json when parsing output programmatically.
For less commonly used commands (auth, license, cloud, templates, config, hub, doctor, env, cache, analytics, changelog, language, completion, bug, upgrade, self-uninstall), run unity <command> --help.
unity shell # run many commands in one warm process (no per-command startup cost)
Enter commands without the unity prefix; leave with exit, quit, or Ctrl-D.
Piped input (... | unity shell) runs every line but always exits 0 — don't
rely on the exit code in scripts.
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | General error |
| 2 | Bad arguments |
| 3 | Authentication failure |
| 4 | Precondition not met (e.g. no license active) |
| 6 | Command-specific failure |
| 130 | Interrupted (Ctrl+C) |
unity editors --installed --format json
unity editors --releases --format json
unity editors list --format json
unity editors --installed --architecture arm64 --format json
For installing, uninstalling, upgrading, or managing modules, use the unity-cli-install skill.
unity projects list --format json
unity projects add /path/to/MyProject
unity projects remove /path/to/MyProject
unity projects info /path/to/MyProject --format json
# Open a project
unity open /path/to/MyProject
unity open /path/to/MyProject --editor-version 6000.0.47f1
unity 6000.0.47f1 /path/to/MyProject # shorthand
# Recommended for pipeline-driven automation: -automated suppresses modal
# dialogs that would otherwise block unattended operation
unity open /path/to/MyProject --editor-version 6000.0.47f1 --args -automated
When opening a project, prefer passing --editor-version explicitly with an
installed version (check with unity editors list) rather than relying on
implicit resolution.
# Create
unity projects create MyGame --editor-version 6000.0.47f1 --template com.unity.template.3d
unity projects create MyGame --path /path/to/projects --editor-version 6000.0.47f1
unity projects new MyGame # non-interactive, resolves from stored defaults
unity projects new MyGame --open
# Clone from VCS
unity projects clone --vcs github --vcs-namespace my-org --vcs-repo my-game --path ./MyGame
unity projects clone --vcs github --vcs-namespace my-org --vcs-repo monorepo \
--path ./repo --project-path packages/MyGame
# Upgrade project to a different editor version
unity projects upgrade /path/to/MyProject --to 6000.0.47f1 --yes
# Cloud / VCS linking
unity projects link cloud /path/to/MyProject --cloud-org <id-or-name>
unity projects unlink cloud /path/to/MyProject
unity projects link vcs /path/to/MyProject \
--vcs github --git-namespace my-org --git-repo my-game --git-token-stdin
unity projects unlink vcs /path/to/MyProject
unity logs
unity logs --tail 50
unity logs --follow
unity logs --level error # trace, debug, info, warn, error, fatal