butterlatte-zhang/unity-ai-bridge

Unity AI Bridge
**Remote-control the Unity Editor from any AI IDE — no ports, no dependencies, just works.**
https://github.com/user-attachments/assets/4e8b3f85-b209-406f-a96e-f8b8eddc9160
---
Why Unity AI Bridge?
Most AI coding assistants can read and write files, but they are **blind to the Unity Editor** — they can't inspect your scene, tweak materials, run tests, or profile performance. Unity AI Bridge gives AI full editor access.
Key Advantages
- **65 tools, 15 categories** — Scene, GameObject, Assets, Prefab, Script, Profiler, LightProbe, Screenshot, Runtime, Tests, and more. Covers the full editor workflow, not just file I/O.
- **File-based IPC, not WebSocket** — No open ports, no firewall issues, no connection drops. Survives recompilation, play-mode transitions, and editor restarts gracefully.
- **Zero external dependencies** — Pure Python stdlib CLI/MCP server, self-contained C# Unity package. No pip install, no npm, no Node.js runtime.
- **Every major AI IDE** — Claude Code (Skill mode), Cursor, GitHub Copilot, Windsurf, Claude Desktop (MCP mode). One Unity plugin, all IDEs.
- **5-line extensibility** — Add custom tools with [BridgeTool] attribute. Auto-discovered, auto-serialized, auto-documented. No registration code needed.
- **Production-tested** — Built for and battle-tested in a large-scale open-world Unity game (50+ developers, 2M+ lines of C#).
vs Unity 6 AI Gateway
Unity 6.2 introduced an official AI Gateway with MCP support. Both projects share the same goal — giving AI agents editor access via MCP — but differ in important ways:
| | Unity AI Bridge | Unity 6 AI Gateway |
|---|---|---|
| **Unity version** | 2022.3 LTS+ | 6.2+ only |
| **Tool coverage** | 65 tools across 15 categories | General-purpose (Scene, Assets, Script, Console) |
| **Deep tooling** | Profiler (snapshot, hotpath, stream), LightProbe, Reflection, Package Manager | Not yet available |
| **IPC mechanism** | File polling (~100ms) | Unix Socket / Named Pipe |
| **Extensibility** | [BridgeTool] attribute — 5 lines | TBD |
In practice, the ~100ms file-polling latency is imperceptible because AI agent think-time dominates each round trip. File IPC also makes cross-process debugging trivial — just inspect the JSON files on disk.
---
Quick Start
> **AI-native project** — Copy the prompt below and send it to your AI coding assistant. The setup guide is written for AI to follow — you don't need to run any commands yourself.
>
>
If you prefer manual setup:
1. **Unity Package** — In Unity: *Window > Package Manager > + > Add package from git URL*:
Or manually copy Packages/com.aibridge.unity from this repo into your project's Packages/ directory.
2. **IDE Integration** — Copy .claude/ to your project root, then configure your IDE per docs/SETUP.md.
Supports: Claude Code (Skill mode), Cursor, GitHub Copilot, Windsurf, Claude Desktop (MCP mode).
---
Tool Categories
65 tools organized into 15 categories:
| Category | Count | Tools |
|----------|:-----:|-------|
| **Scene** | 7 | scene-open, scene-save, scene-create, scene-list-opened, scene-get-data, scene-set-active, scene-unload |
| **GameObject** | 11 | gameobject-find, gameobject-create, gameobject-destroy, gameobject-modify, gameobject-duplicate, gameobject-set-parent, gameobject-component-add, gameobject-component-destroy, gameobject-component-get, gameobject-component-list-all, gameobject-component-modify |
| **Assets** | 11 | assets-find, assets-find-built-in, assets-get-data, assets-modify, assets-move, assets-copy, assets-delete, assets-create-folder, assets-refresh, assets-material-create, assets-shader-list-all |