Unity CLI 1.0.0-beta.2
37 documented changes.
- Version
- 1.0.0-beta.2
- Released
- Jul 16, 2026
- Product
- Unity CLI
Unity CLI 1.0.0-beta.2
Interactive shell
- Feature
Added `unity shell` , an interactive session that boots the CLI once and runs many commands in the same warm process. Enter any command without the `unity` prefix, and leave with `exit` , `quit` , or Ctrl+D. Interactive prompts work inside the shell, and a change made by one command is visible to the next.
Proxy diagnostics
- Fix
Added `unity diagnose proxy` to print a redacted, paste-safe proxy diagnostic report: the resolved proxy and its source, PAC configuration, CA bundle, and credential-store and Kerberos checks.
- Feature
Added the global `--log-proxy` flag (or `UNITY_LOG_PROXY=1` ) to log one redacted entry per outbound request for reproducing proxy issues.
- Fix
Fixed part of the CLI's HTTPS traffic bypassing the configured proxy. Sign-in, template and release lookups, `unity bug` , and `unity upgrade` traffic now route through the same proxy stack as downloads, and `--proxy-disable` now forces a direct connection.
Unity pipeline package
- Feature
Added `unity pipeline upgrade` to upgrade the Unity pipeline package in a project when the registry has a newer version.
- Feature
Added `unity pipeline list-versions` to list every published version of the package, and `unity pipeline install --package-version ` to install a specific version.
- Improvement
Updated `unity pipeline list` to show each project's installed package version and flag when a newer version is available.
- Feature
Added `unity list` , a discovery command that queries the connected Unity Editor and prints every registered tool with its name, description, group, and parameter schema.
Editor and module installation
- Feature
Added `--reinstall` and `-f, --force` to `unity install-modules` to repair modules that are already installed.
- Feature
Added automatic retries for module downloads that fail intermittently. Tune or disable retries with `--retries ` or `UNITY_INSTALL_RETRIES` .
- Feature
Added `--no-elevate` (or `UNITY_NO_ELEVATE=1` ) on Windows to skip the elevated (UAC) install helper for user-writable install locations and CI shells.
- Windows
- Improvement
Updated `unity install` and `unity install-modules` to continue installing the remaining modules when one fails, and to report a per-item result for each Editor and module on both success and failure.
- Feature
Added a desktop entry for installed Editors on Linux, so a launched Editor shows the Unity name and icon in the taskbar.
- Linux
Diagnostics
- Feature
Added environment health checks to `unity doctor` : whether the `unity` binary's directory is on `PATH` , whether multiple `unity` binaries shadow each other, and whether Windows long-path support is enabled.
- Windows
Installation and updates
- Improvement
Updated `unity upgrade` to detect how the CLI was installed. On a package-manager install, it points you at the owning manager instead of replacing the binary in place.
- Feature
Added GPG signing and AppImage-native update information to the Linux AppImage, so third-party updaters can check for and apply CLI updates.
- Linux
CLI behavior
- Feature
Added "Did you mean" suggestions for unknown commands that look like a typo of a real one.
- Improvement
Updated command modules to load only when their command runs, reducing startup time on every invocation.
- Removal
Removed `--instance ` from `unity command` and `unity mcp` . The CLI now always discovers running Editors itself; run from the project directory or pass `--project-path` to target one.
- Removal
Removed the regional display languages Spanish (Latin America), French (Canada), and Portuguese (Portugal) from `unity language` . Spanish, French, and Portuguese (Brazil) remain available.
- Improvement
Updated the first-run consent prompt to require an explicit `y` or `n` answer.
Security
- Security
Hardened the Editor and module installers against command injection through the configured install location.
- Security
Updated `unity hub install` to verify that the downloaded installer is signed by Unity specifically, instead of accepting any validly signed binary.
- Security
Extended escape-sequence hardening to more output surfaces, including `unity projects list` and the detail views.
Issues fixed
- Fix
Fixed the `lts` version alias resolving to the newest Supported-stream release instead of the newest Long Term Support (LTS) release.
- Fix
Fixed command hints showing literal markdown backticks. Commands now render in cyan on color terminals and as plain text elsewhere.
- Fix
Fixed the CLI requiring the Microsoft Visual C++ Redistributable on Windows.
- Windows
- Fix
Fixed Unity 2021 and 2022 Editors failing to start when launched through the CLI on Windows.
- Windows
- Fix
Fixed the `unity license` commands not recognizing service-account sessions, and fixed `unity license return` not returning serial-activated licenses.
- Fix
Fixed file sizes printing a literal `undefined` where the unit belongs.
- Fix
Fixed installing the Visual Studio module opening the interactive Visual Studio Installer on Editor versions whose release manifest omits the install command.
- Fix
Fixed `unity templates list` and `unity templates info` silently falling back to cached template data when the template registry is unreachable. The CLI now prints a warning when it shows cached data.
- Fix
Fixed concurrent module installs corrupting the Editor's module state or failing with misleading permission errors.
- Fix
Fixed the install scripts failing on systems without a shell startup file, and fixed the Windows install script failing to parse under Windows PowerShell 5.1 when saved to disk.
- Windows
- Fix
Fixed authentication failures in the `unity cloud` commands exiting with code `6` instead of `3` , and aligned operational failures in the cloud and auth commands on exit code `6` .
- Fix
Fixed interrupted builds exiting with a generic `1` . Interrupting `unity build` now exits `130` for Ctrl+C and `143` for `SIGTERM` .
- Fix
Fixed `unity upgrade` failing with a 404 error when the Unity Hub ran in a non-production environment on the same machine.