uloop-launch
uloop launch
Launch Unity Editor with the correct version for a project.
uloop launch is not fire-and-forget. When Unity needs to start or restart, the command waits
until Unity is actually ready for CLI operations before it exits.
Usage
uloop launch [project-path] [options]
Parameters
| Parameter | Type | Description |
|---|---|---|
project-path |
string | Optional. Use only when the target Unity project is not in the current directory. |
-r, --restart |
boolean | Kill running Unity and restart |
-p, --platform <P> |
string | Build target (e.g., StandaloneOSX, Android, iOS) |
--max-depth <N> |
number | Search depth when project-path is omitted (default: 3, -1 for unlimited) |
-a, --add-unity-hub |
boolean | Add to Unity Hub only (does not launch) |
-f, --favorite |
boolean | Add to Unity Hub as favorite (does not launch) |
Examples
# Search for Unity project in current directory and launch
uloop launch
# Launch specific project
uloop launch /path/to/project
# Restart Unity (kill existing and relaunch)
uloop launch -r
# Launch with build target
uloop launch -p Android
# Add project to Unity Hub without launching
uloop launch -a
Output
- Prints detected Unity version
- Prints project path
- If Unity is already running, focuses the existing window
- If launching, waits until Unity finishes startup and the CLI can connect to the project
More from hatayama/uloopmcp
uloop-find-game-objects
Use first when the user asks about the currently selected GameObject in the Unity Hierarchy. Inspect selected object details with `--search-mode Selected` before using `execute-dynamic-code`. Use when you need to: (1) Get details and component properties for selected GameObject(s), (2) Search for objects by name, regex, or path, (3) Find objects with specific components, tags, or layers. Use get-hierarchy when the child tree under the selection is needed. Returns hierarchy paths, active state, tags, layers, and components (or writes to a file when multiple GameObjects are selected).
37uloop-unity-search
Search Unity project assets using Unity Search engine. Use when you need to: (1) Find scenes, prefabs, scripts, materials, or other assets, (2) Filter assets by file extension or type, (3) Search with Unity Search query syntax and specific providers. Returns asset paths and metadata.
36uloop-clear-console
Clear all Unity Console log entries. Use when you need to: (1) Clear console before running tests or compilation, (2) Start a fresh debugging session, (3) Remove noisy logs to isolate specific output.
36uloop-run-tests
Execute Unity Test Runner and get detailed results. Use when you need to: (1) Run EditMode or PlayMode unit tests, (2) Verify code changes pass all tests, (3) Diagnose test failures with error messages and stack traces. Single-flight only — never run multiple `uloop run-tests` in parallel.
35uloop-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.
34uloop-execute-menu-item
Execute Unity Editor menu commands programmatically. Use when you need to: (1) Trigger menu commands like save, build, or refresh, (2) Automate editor actions via menu paths, (3) Run custom menu items defined in project scripts.
33