Unity CLI Loop

Agent skill by hatayama · for Claude Code, Codex, Cursor, GitHub Copilot and Google Antigravity

A free MIT Unity package, CLI and skill set that lets Claude Code, Codex, Cursor and other agents compile, run tests, read logs, hot-reload code, pause on a line, take screenshots and simulate keyboard and mouse input in Play Mode.

Install

brew install hatayama/tap/uloop

Run it in a terminal, then start a new agent session so the skill loads. Read the repo's README and scripts before you install: skills run with your agent's permissions.

What it does

Unity CLI Loop, made by hatayama, connects an AI coding agent to a running Unity Editor through a command-line tool called uloop. The goal is a loop where the agent writes code, compiles it, runs tests, reads the console and fixes problems with little human help.

Beyond compiling and running Test Runner tests, it can run C# inside the editor or the running game, save the scene hierarchy, find GameObjects, take screenshots, apply method-body changes during Play Mode without a full recompile, and stop on a chosen source line to read that frame's variables. In Play Mode the agent can also press keys, move and click the mouse and replay recorded input to check that a feature actually works.

Setup has three parts: the uloop CLI, the Unity package (added with uloop or from a Git URL in Package Manager) and the skills, installed into Claude Code or any tool that reads .agents/skills. Version 3 dropped the earlier Node.js and port setup.

Features

  • Compile, run tests and read console logs from the agent
  • Hot-reload method changes during Play Mode
  • Pause on a source line and read that frame's variables
  • Simulate keyboard, mouse and recorded input in Play Mode
  • Screenshots for checking UI and scenes

Limits

  • Needs Unity 2022.3 or later
  • Three-part setup: CLI, Unity package and skills
  • The Homebrew install is macOS only; Linux and Windows use the README's install scripts

Similar skills and which to pick

Browse all 74 agent skills