| name | uloop-launch |
| description | Use when Unity Editor is not running or needs a clean restart. |
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.
uloop launch [project-path] [options]
| 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) |
# 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
Clear Unity Console entries. Use before compile, tests, or debugging when stale logs would hide the current result.
Compile the Unity project and report errors/warnings. Use after C# edits or when a full Domain Reload compile is needed.
Control Unity Editor Play Mode. Use to start, stop, or pause Play Mode for runtime behavior checks and frame inspection.
Execute C# with Unity APIs when existing uloop tools cannot inspect or edit enough. Use for scene, prefab, SerializedObject, AssetDatabase refresh/.meta generation, menu, or PlayMode automation.
Find or inspect Unity GameObjects, especially objects the user currently selected in the Hierarchy. Use for details, components, tags, layers, or name/path searches.
Get the Unity scene hierarchy as a structured tree. Use for parent-child structure, descendants, roots, or subtrees under objects the user currently selected.