Summary

Unity CLI Loop provides an AI-driven autopilot for Unity projects, enabling autonomous compilation, testing, debugging, and operational tasks via a command-line interface. It targets developers seeking to integrate LLMs for automated project management and development cycles, significantly reducing manual intervention.

How It Works

The system exposes core Unity Editor operations as tools that Large Language Models (LLMs) can orchestrate. It employs a minimal toolset philosophy, prioritizing execute-dynamic-code for broad C# script execution and dedicated tools for essential functions like compilation, log retrieval, and input simulation. This approach aims to simplify LLM interaction and conserve context window usage.

Quick Start & Requirements

• Requirements: Unity 2022.3+, Node.js 22.0+.
• Installation:
  • Unity Package Manager (Git URL): https://github.com/hatayama/unity-cli-loop.git?path=/Packages/src
  • OpenUPM (Recommended): Add registry https://package.openupm.com (scope io.github.hatayama.uloopmcp).
  • CLI Install: npm install -g uloop-cli.
  • Skill Install: uloop skills install --claude (or --codex, --global).
• Setup: Involves installing Unity, Node.js, the Unity package, and the CLI tool, followed by skill installation for LLM integration.

Highlighted Details

• Development Loop Automation: Features tools for compiling, analyzing errors/warnings, running tests (Edit/Play mode), and retrieving detailed console logs with advanced search.
• Editor & PlayMode Control: Enables AI-driven scene manipulation, menu item execution, object searching, UI interaction via mouse/keyboard simulation, and Play Mode control.
• Dynamic C# Execution: The execute-dynamic-code tool offers powerful, configurable (Level 1/2 security) C# script execution for rapid prototyping and batch processing.
• Input Simulation & Recording: Supports simulating mouse/keyboard input via Input System, and recording/replaying user actions during PlayMode.

Maintenance & Community

The provided README does not detail specific contributors, sponsorships, or community channels like Discord/Slack. It references sample extension projects and implementation guides for development.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Permissive for commercial use. Requires specific Unity and Node.js versions.

Limitations & Caveats

The focus-window tool is not supported on Linux. MCP connection is noted as potentially deprecated in favor of the CLI. Security settings for certain tools (e.g., execute-dynamic-code, third-party tools) require explicit enabling within the Unity Editor. PlayMode tests disable Domain Reload, which can impact static variable state.