Agent skill

uloop-compile

Compile Unity project and report errors/warnings. Use when you need to: (1) Verify code compiles after C# file edits, (2) Check for compile errors before testing, (3) Force full recompilation with Domain Reload. Returns error and warning counts.

View SKILL.md on GitHub Repository
Stars 249
Forks 21

Install this agent skill to your Project

npx add-skill https://github.com/hatayama/unity-cli-loop/tree/main/.claude/skills/uloop-compile

SKILL.md

uloop compile

Execute Unity project compilation.

Usage

bash
uloop compile [--force-recompile] [--wait-for-domain-reload]

Parameters

Parameter Type Default Description
--force-recompile boolean false Force full recompilation (triggers Domain Reload)
--wait-for-domain-reload boolean false Wait until Domain Reload completes before returning

Global Options

Option Description
--project-path <path> Target a specific Unity project (mutually exclusive with --port)
-p, --port <port> Specify Unity TCP port directly (mutually exclusive with --project-path)

Examples

bash
# Check compilation
uloop compile

# Force full recompilation
uloop compile --force-recompile

# Force recompilation and wait for Domain Reload completion
uloop compile --force-recompile true --wait-for-domain-reload true

# Wait for Domain Reload completion even without force recompilation
uloop compile --force-recompile false --wait-for-domain-reload true

Output

Returns JSON:

  • Success: boolean
  • ErrorCount: number
  • WarningCount: number

Troubleshooting

If CLI hangs or shows "Unity is busy" errors after compilation, stale lock files may be preventing connection. Run the following to clean them up:

bash
uloop fix

This removes any leftover lock files (compiling.lock, domainreload.lock, serverstarting.lock) from the Unity project's Temp directory.

Didn't find tool you were looking for?

Be as detailed as possible for better results