A major release that adds core workflow commands for diagnostics, Editor management, project management, and automation.

Version
0.1.0-beta.4
Released
May 7, 2026
Product
Unity CLI
Unity CLI release notes

Unity CLI 0.1.0-beta.4

Official notes

Diagnostics and inspection

  1. Feature

    Added `unity doctor` to generate a diagnostic snapshot that includes platform information, CLI version, installation path, log directory, authentication status, installed Editors, and recent log entries.

  2. Feature

    Added `unity completion ` to generate shell completion scripts.

  3. Feature

    Added `unity env` to display environment variables used by Unity CLI and Unity Hub.

  4. Feature

    Added `unity logs` to view and follow Unity Hub log files.

  5. Feature

    Added `unity editors info ` to display detailed metadata for an installed Editor.

  6. Feature

    Added `unity releases` to list available Unity releases from the release feed.

  7. Feature

    Added `unity modules list ` to display available modules for an Editor version.

  8. Feature

    Added `unity templates list` and `unity templates info ` to list project templates and view template details.

Editor management and installation

  1. Feature

    Added `unity editors add ` to register an existing Editor installation with Unity Hub.

  2. Feature

    Added `unity editors default []` to get or set the default Editor.

  3. Feature

    Added `unity editors install-path []` to get or set the Editor installation path.

  4. Feature

    Added commands to list and install modules for an installed Editor.

  5. Feature

    Added `unity install --dry-run` to preview Editor installations.

  6. Feature

    Added `unity install --force` to reinstall an Editor that is already installed.

  7. Feature

    Added `unity install --resume` to resume interrupted downloads from the local cache.

  8. Feature

    Added `unity install-modules --dry-run` to preview module installations.

  9. Feature

    Added prompts to accept module license agreements before downloading modules.

  10. Feature

    Added `unity cache info` and `unity cache clean` to view and manage the download cache.

Project management

  1. Feature

    Added `unity projects open []` to open a project by using a fuzzy-matched project name when no exact path is provided.

  2. Feature

    Added `unity projects new --template --editor-version ` to create projects non-interactively for scripts and CI workflows.

  3. Feature

    Added `unity projects pin ` and `unity projects unpin ` to manage favorite projects.

  4. Feature

    Added `unity projects export` and `unity projects import` to export and import project lists in JSON format.

  5. Feature

    Added `unity projects info ` to display Editor, module, and cloud information for a project.

  6. Feature

    Added `unity projects upgrade [] --to ` to upgrade a project to a different Editor version.

  7. Feature

    Added `unity projects require ...` to verify that required modules are installed for a project.

  8. Feature

    Added automatic Editor version detection for `open` , `install` , and `uninstall` when no version is specified and the current working directory contains a Unity project.

CI and automation

  1. Feature

    Added `unity run` to execute projects in batch mode, stream logs, and return the Editor exit code.

  2. Feature

    Added NDJSON progress output for long-running commands, including `unity build` and `unity projects new` .

Output and integration

  1. Feature

    Added a standardized JSON output envelope that includes `success` , `command` , `data` , `errors` , and `warnings` .

  2. Feature

    Added the `ndjson` output format for streaming progress updates from long-running commands.

  3. Feature

    Added documentation for the `tsv` output format alongside `human` and `json` .

  4. Feature

    Added global `--non-interactive` , `--quiet` , and `--no-banner` options.

  5. Feature

    Added `-y` and `--yes` options for commands that require confirmation.

  6. Feature

    Added `-w` and `--watch` options to keep Editor and project lists updated automatically.

  7. Feature

    Added environment variables that mirror global CLI options, including `UNITY_FORMAT` , `UNITY_QUIET` , `UNITY_NO_BANNER` , and `UNITY_NON_INTERACTIVE` . `HUB_FORMAT` remains supported as an alias for `UNITY_FORMAT` .

  8. Feature

    Added searchable version selectors for interactive workflows.

  9. Change

    Extended exit code support to include authentication, network, conflict, usage, and command-specific errors.

Platform and extensibility

  1. Feature

    Added `unity [path]` as a shorthand command to launch an Editor with an optional project path.

  2. Feature

    Added plugin discovery for executables named `unity-` , which Unity CLI exposes as `unity ` .

  3. Feature

    Added `unity self-uninstall` to remove the CLI binary, environment files, and stored credentials.

  4. Feature

    Added `unity report-bug` to launch the Unity Hub bug reporter or create a structured bug report.

  5. Feature

    Added `unity upgrade --rollback` to restore the previously installed CLI version.

CLI behavior

  1. Deprecation

    Deprecated `unity implode` in favor of `unity self-uninstall` .

  2. Improvement

    Updated automatic update checks to run in the background without blocking command execution.

  3. Improvement

    Enhanced `unity editors list` to display version aliases, identify the default Editor, and resolve installation paths.

  4. Improvement

    Improved `unity auth login` for remote and headless environments by displaying the sign-in URL before attempting to launch a browser.

  5. Feature

    Added authentication progress events to JSON output so automation tools can capture sign-in URLs programmatically.

Issues fixed

  1. Fix

    Fixed an issue where `unity auth` could fail to start the sign-in flow after a fresh installation.

  2. Removal

    Fixed an issue on Windows where `unity auth` removed query parameters from the OAuth callback URL, which could prevent sign-in from completing.

    • Windows
  3. Fix

    Fixed an issue on Windows where `unity upgrade` could fail to replace the CLI binary.

    • Windows
  4. Fix

    Fixed issues in `unity projects upgrade` related to project name lookups, confirmation prompts, and short version aliases.

  5. Fix

    Fixed an issue where `unity editors info` did not expand short major-version aliases.

  6. Fix

    Fixed issues in `unity install-modules` that prevented correct handling of invalid Editor versions, version aliases, and ambiguous version matches.

  7. Fix

    Fixed an issue where `unity install --dry-run` reported incorrect download sizes when the Editor was already installed.

  8. Fix

    Updated `unity projects require` to accept a project name in addition to a project path.

  9. Fix

    Fixed an issue where the Windows installer could corrupt the system `PATH` .

    • Windows
  10. Fix

    Added ASCII fallback support for terminals that do not support Unicode characters.

  11. Fix

    Routed module installation errors to `stderr` to improve scripting and output redirection.

  12. Fix

    Fixed Linux configuration directory inconsistencies between Unity CLI and Unity Hub to keep settings, projects, and Editors synchronized.

    • Linux
  13. Fix

    Fixed startup failures in Bun runtimes that do not support `mkdtempDisposable` .

  14. Fix

    Fixed startup failures in packaged Bun binaries caused by an unnecessary runtime dependency on `@vscode/proxy-agent` .

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.