uloop-compile

star 5

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.

hatayama By hatayama schedule Updated 3/7/2026

name: uloop-compile description: "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."

uloop compile

Execute Unity project compilation.

Usage

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

# 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:

uloop fix

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

Install via CLI
npx skills add https://github.com/hatayama/unity-ai-cli-bridge --skill uloop-compile
Repository Details
star Stars 5
call_split Forks 1
navigation Branch main
article Path SKILL.md
More from Creator