37 documented changes.

Version
1.0.0-beta.2
Released
Jul 16, 2026
Product
Unity CLI
Unity CLI release notes

Unity CLI 1.0.0-beta.2

Official notes

Interactive shell

  1. 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

  1. 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.

  2. Feature

    Added the global `--log-proxy` flag (or `UNITY_LOG_PROXY=1` ) to log one redacted entry per outbound request for reproducing proxy issues.

  3. 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

  1. Feature

    Added `unity pipeline upgrade` to upgrade the Unity pipeline package in a project when the registry has a newer version.

  2. 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.

  3. Improvement

    Updated `unity pipeline list` to show each project's installed package version and flag when a newer version is available.

  4. 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

  1. Feature

    Added `--reinstall` and `-f, --force` to `unity install-modules` to repair modules that are already installed.

  2. Feature

    Added automatic retries for module downloads that fail intermittently. Tune or disable retries with `--retries ` or `UNITY_INSTALL_RETRIES` .

  3. 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
  4. 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.

  5. 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

  1. 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

  1. 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.

  2. 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

  1. Feature

    Added "Did you mean" suggestions for unknown commands that look like a typo of a real one.

  2. Improvement

    Updated command modules to load only when their command runs, reducing startup time on every invocation.

  3. 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.

  4. Removal

    Removed the regional display languages Spanish (Latin America), French (Canada), and Portuguese (Portugal) from `unity language` . Spanish, French, and Portuguese (Brazil) remain available.

  5. Improvement

    Updated the first-run consent prompt to require an explicit `y` or `n` answer.

Security

  1. Security

    Hardened the Editor and module installers against command injection through the configured install location.

  2. Security

    Updated `unity hub install` to verify that the downloaded installer is signed by Unity specifically, instead of accepting any validly signed binary.

  3. Security

    Extended escape-sequence hardening to more output surfaces, including `unity projects list` and the detail views.

Issues fixed

  1. Fix

    Fixed the `lts` version alias resolving to the newest Supported-stream release instead of the newest Long Term Support (LTS) release.

  2. Fix

    Fixed command hints showing literal markdown backticks. Commands now render in cyan on color terminals and as plain text elsewhere.

  3. Fix

    Fixed the CLI requiring the Microsoft Visual C++ Redistributable on Windows.

    • Windows
  4. Fix

    Fixed Unity 2021 and 2022 Editors failing to start when launched through the CLI on Windows.

    • Windows
  5. Fix

    Fixed the `unity license` commands not recognizing service-account sessions, and fixed `unity license return` not returning serial-activated licenses.

  6. Fix

    Fixed file sizes printing a literal `undefined` where the unit belongs.

  7. Fix

    Fixed installing the Visual Studio module opening the interactive Visual Studio Installer on Editor versions whose release manifest omits the install command.

  8. 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.

  9. Fix

    Fixed concurrent module installs corrupting the Editor's module state or failing with misleading permission errors.

  10. 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
  11. 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` .

  12. Fix

    Fixed interrupted builds exiting with a generic `1` . Interrupting `unity build` now exits `130` for Ctrl+C and `143` for `SIGTERM` .

  13. Fix

    Fixed `unity upgrade` failing with a 404 error when the Unity Hub ran in a non-production environment on the same machine.

Pick your Unity version

Unity Releases compares releases against the version your project is on. Picking it now keeps Compare versions focused on what changes between where you are and where you might be going.