You:    "Create 10 cubes in a circle and add Rigidbody to each"
Claude: Done. 10 cubes created at radius 5, each with a Rigidbody component.

⚡ CLI + Skills

CLI commands exposed through Claude Code's skill system.

• Token-efficient. Skills load on demand.
• Unrestricted. Falls back to a full Roslyn C# REPL — not limited to predefined tools.
• No sidecar. Service runs inside Unity Editor. No extra process.
• Workflow-aware. Understands Unity's compile lifecycle, play mode, domain reload.
• Automatic custom command discovery. User-defined C# commands are synced into the skill catalog.
• Runtime / IL2CPP support. Works with HybridCLR for runtime builds.

🚀 Quick Start — Claude Code

Prerequisites: Claude Code, Unity 2022.3+, Python 3.7+

# 1. Add the marketplace & install the plugin
claude plugin marketplace add niqibiao/unity-cli-plugin
claude plugin install unity-cli-plugin

# 2. Install the Unity package (inside your project)
claude
> /unity-cli-setup

# 3. Verify
> /unity-cli-status

🚀 Quick Start — Codex CLI (Experimental)

Note: Codex CLI does not yet officially support third-party plugin distribution. The steps below rely on the local workspace marketplace, which may change in future releases.

Prerequisites: Codex CLI, Unity 2022.3+, Python 3.7+

# 1. Start Codex in your Unity project
cd /path/to/your/unity-project
codex

# 2. Tell Codex to clone and install the plugin:
#    "Clone https://github.com/niqibiao/unity-cli-plugin/tree/codex-plugin
#     then run install.sh with the current directory"

# 3. Restart Codex, find and install the plugin
/plugins              # locate unity-cli-plugin → Install

# 4. Restart Codex again, then initialize the Unity package
$unity-cli-setup

# 5. Verify
$unity-cli-status

cd /path/to/your/unity-project
git clone --depth=1 -b codex-plugin https://github.com/niqibiao/unity-cli-plugin.git plugins/unity-cli-plugin
rm -rf plugins/unity-cli-plugin/.git

{
  "name": "local-workspace",
  "plugins": [{
    "name": "unity-cli-plugin",
    "source": { "source": "local", "path": "./plugins/unity-cli-plugin" },
    "policy": { "installation": "INSTALLED_BY_DEFAULT", "authentication": "ON_INSTALL" },
    "category": "Productivity"
  }]
}

💬 Usage

Just tell Claude what you want:

> Add a directional light and rotate it 45 degrees on X
> Find all "Enemy" objects and list their components
> Take a screenshot of the Scene View
> Start profiler recording with deep profiling

Claude picks the right command or writes C# code as needed.

⌨️ Slash Commands

💻 Direct CLI

python cli/cs.py exec --json --project . "Debug.Log(\"Hello\")"
python cli/cs.py command --json --project . gameobject create '{"name":"Cube","primitiveType":"Cube"}'
python cli/cs.py refresh --json --project . --exit-playmode --wait 60
python cli/cs.py batch --json --project . '[{"ns":"gameobject","action":"create","args":{"name":"A"}},{"ns":"gameobject","action":"create","args":{"name":"B"}}]'
python cli/cs.py list-commands --json --project . --timeout 10
python cli/cs.py catalog sync --json --project .
python cli/cs.py catalog list --json --project .

📦 Commands

50 built-in commands across 13 namespaces. All commands support --json output.

gameobject

component

transform

scene

prefab

material

screenshot

profiler

editor

asset

project

session

command

🔧 Custom Commands

Custom commands are supported. See unity-csharpconsole for how to define and register them.

The plugin maintains a persistent per-project catalog of custom commands. Run cs catalog sync to pull the latest list from Unity and cache it to disk; run cs catalog list to view the cached catalog offline without connecting to the Editor.

🏗️ Architecture

Claude Code                      Unity Editor
┌──────────────────┐            ┌──────────────────────────┐
│  Skills          │            │  com.zh1zh1.csharpconsole│
│  ┌────────────┐  │            │  ┌────────────────────┐  │
│  │ cli-command│──┼── HTTP ──▶ │  │ ConsoleHttpService │  │
│  │ cli-exec   │  │            │  │  ├─ CommandRouter  │  │
│  └────────────┘  │            │  │  ├─ REPL Compiler  │  │
│                  │            │  │  └─ REPL Executor  │  │
│  Python CLI      │            │  └────────────────────┘  │
│  ┌────────────┐  │            │                          │
│  │ cs.py      │  │            │  40+ CommandActions      │
│  │ core_bridge│  │            │  (GameObject, Component, │
│  └────────────┘  │            │   Prefab, Material, ...) │
└──────────────────┘            └──────────────────────────┘

• Plugin layer: Skills and slash commands invoked by Claude Code
• CLI layer: Python dispatcher, serializes requests to JSON
• Unity layer: unity-csharpconsole — HTTP service, auto-discovered command handlers, Roslyn C# REPL

Auto-detects project root and service port. No manual configuration.

❓ Troubleshooting

License

Apache-2.0

If this plugin saves you time, consider giving it a star. It helps others find it.