unity-cli

March 9, 2026 · View on GitHub

unity-cli ist eine Rust CLI, mit der Claude Code den Unity Editor direkt uber TCP steuern kann. Es ist der Nachfolger von unity-mcp-server und wurde von Node.js + MCP auf einen nativen Binary Workflow umgestellt.

Warum unity-cli

Unity aus Claude Code mit fokussierten Skills und typed Befehlen steuern.
101 Unity Tool APIs fur Szene, Assets, Code, Tests, UI und Editor nutzen.
Einzelnes Binary mit schnellem Start und geringem Overhead.

Architektur

Claude Code
  -> Skills (on demand)
  -> unity-cli
  -> Unity Editor (TCP bridge)

Einige Code Tools (read, search, find_symbol, find_refs usw.) laufen lokal ohne Unity Verbindung.

Einstieg

Empfohlen: Claude Code Plugin

Installieren Sie das unity-cli Plugin aus dem Claude Code Marketplace:

/plugin marketplace add akiojin/unity-cli

Das Marketplace Plugin installiert nur Skills. Installieren Sie das unity-cli Binary separat mit einer der manuellen Optionen unten.

Codex Skills

Wenn Sie dieses Repository mit Codex verwenden, sind Skills uber .codex/skills/ verfugbar (Symlinks zur Plugin Quelle). Es ist keine zusatzliche Einrichtung erforderlich — klonen Sie einfach das Repository.

Manuelle Installation

Laden Sie das neueste Binary von GitHub Releases herunter oder installieren Sie es aus einem lokalen Checkout:

git clone https://github.com/akiojin/unity-cli.git
cd unity-cli
cargo install --path .

Bridge Paket auf Unity Seite (eine Option wahlen):

OpenUPM (empfohlen):

openupm add com.akiojin.unity-cli-bridge

Git URL (Unity Package Manager):

https://github.com/akiojin/unity-cli.git?path=UnityCliBridge/Packages/unity-cli-bridge

Verbindungstest:

unity-cli system ping

Skills (13)

Kategorie	Skills
Einstieg	`unity-cli-usage`
Szenen und Objekte	`unity-scene-create`, `unity-scene-inspect`, `unity-gameobject-edit`, `unity-prefab-workflow`
Assets	`unity-asset-management`, `unity-addressables`
Code	`unity-csharp-navigate`, `unity-csharp-edit`
Laufzeit und Tests	`unity-playmode-testing`, `unity-input-system`, `unity-ui-automation`
Editor	`unity-editor-tools`

Schnelle Beispiele

# Verbindung
unity-cli system ping

# Szene erstellen
unity-cli scene create MainScene

# GameObject uber raw Aufruf erstellen
unity-cli raw create_gameobject --json '{"name":"Player"}'

# C# Code durchsuchen (lokales Tool)
unity-cli tool call search --json '{"pattern":"PlayerController"}'

# EditMode Tests ausfuhren
unity-cli tool call run_tests --json '{"mode":"editmode"}'

Konfiguration

Variable	Beschreibung	Standard
`UNITY_PROJECT_ROOT`	Verzeichnis mit `Assets/` und `Packages/`	auto-detect
`UNITY_CLI_HOST`	Unity Editor Host	`localhost`
`UNITY_CLI_PORT`	Unity Editor Port	`6400`
`UNITY_CLI_TIMEOUT_MS`	Command Timeout (ms)	`30000`
`UNITY_CLI_LSP_MODE`	LSP Modus (`off` / `auto` / `required`)	`off`
`UNITY_CLI_TOOLS_ROOT`	Root Verzeichnis fur heruntergeladene Tools	OS default

Legacy MCP Umgebungsvariablen werden nicht unterstutzt. Nutzen Sie nur UNITY_CLI_*.

Dokumentation

Vollstandiger Command und Tool Katalog: docs/tools.md
Entwicklungsworkflow und CI: docs/development.md
Beitragshandbuch: CONTRIBUTING.md
Release Prozess: RELEASE.md
Attribution Vorlagen: ATTRIBUTION.md

Lizenz

MIT. Siehe ATTRIBUTION.md fur Attribution Vorlagen bei Redistribution.