UTerminal.Cli 0.1.0

UTerminal CLI

ut is a project-local command front end for UTerminal's Unity-aware command layer.

It connects to the running Unity Editor through UTerminal's local command pipe, then invokes the UTerminal.Command tool.

Usage

ut help
ut status
ut check
ut wait ready --timeout 60
ut test run --mode EditMode
ut scene active
ut scene hierarchy --depth 3
ut build scenes
ut unity refresh
ut unity compile
ut play start
ut package list
ut package install com.unity.textmeshpro
ut package wait --timeout 120
ut console errors

Local Install Test

dotnet pack UTerminalCli/UTerminalCli/UTerminalCli.csproj -c Release -o UTerminalCli/nupkg
dotnet tool install UTerminal.Cli --tool-path Library/UTerminal --add-source UTerminalCli/nupkg
Library/UTerminal/ut help

New UTerminal tabs prepend Library/UTerminal to PATH, so project-local installs can be called as ut. External shells do not inherit that project-local path automatically; use .\Library\UTerminal\ut.exe or add the folder to your shell PATH.

Run it from a Unity project directory or pass the project root explicitly:

ut --project C:\path\to\UnityProject console warnings

Options

--project <path>   Unity project root. Defaults to current directory or a parent.
--pipe <name>      Override the UTerminal MCP pipe name.
--timeout <sec>    Connection and response timeout. Default: 15.
--json             Print the raw command result JSON.
--help             Show CLI help.

Unity must be open with the UTerminal package loaded. The CLI reads Library/UTerminal/uterminal-pipe.txt when available so external shells use the same pipe name Unity started, even when project paths differ by casing or symlinks.

ut package wait can recover package install/remove jobs after a Unity domain reload because job metadata is persisted under Library/UTerminal/PackageJobs.

License

UTerminal CLI is distributed as a companion tool for licensed UTerminal users. It is not MIT-licensed. See LICENSE.md in the NuGet package for the full terms.