$git clone https://github.com/hatayama/unity-cli-loopLet an AI agent compile, test, and operate your Unity project from popular LLM tools via CLI.
| 1 | # Unity CLI Loop |
| 2 | [日本語](README_ja.md) |
| 3 | |
| 4 | [](https://unity3d.com/) |
| 5 | [](LICENSE.md)<br> |
| 6 |  |
| 7 |  |
| 8 |  |
| 9 |  |
| 10 |  |
| 11 | |
| 12 | <p align="center"> |
| 13 | <img height="450" alt="logo-black-bg" src="https://github.com/user-attachments/assets/fca3047f-9042-4bf9-83bd-58b03f061082" /><br> |
| 14 | <sub>(Logo inspired by Daft Punk's <i>Discovery</i> album art)</sub> |
| 15 | </p> |
| 16 | |
| 17 | |
| 18 | Let an AI agent compile, test, and operate your Unity project from popular LLM tools via CLI. |
| 19 | |
| 20 | Designed to keep AI-driven development loops running autonomously inside your existing Unity projects. |
| 21 | |
| 22 | > **Note**: This project was formerly known as **uLoopMCP**. |
| 23 | |
| 24 | # Concept |
| 25 | Unity CLI Loop is a Unity integration tool designed so that **AI can drive your Unity project forward with minimal human intervention**. |
| 26 | Tasks that humans typically handle manually—compiling, running the Test Runner, checking logs, editing scenes, and capturing windows to verify UI layouts—are exposed as tools that LLMs can orchestrate. |
| 27 | |
| 28 | Unity CLI Loop is built around four core ideas: |
| 29 | |
| 30 | 1. **A self-hosted development loop where AI autonomously compiles, tests, inspects logs, and fixes issues.** Uses `compile`, `run-tests`, `get-logs`, `clear-console`. |
| 31 | 2. **AI-driven Unity Editor operation—scene building, object manipulation, menu execution, and UI refinement from screenshots.** Uses `execute-dynamic-code`, `screenshot`. |
| 32 | 3. **PlayMode automated testing—AI clicks buttons, drags elements, presses keys, records and replay |