Unity CLI 0.1.0-beta.4
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 0.1.0-beta.4
Diagnostics and inspection
- 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.
- Feature
Added `unity completion ` to generate shell completion scripts.
- Feature
Added `unity env` to display environment variables used by Unity CLI and Unity Hub.
- Feature
Added `unity logs` to view and follow Unity Hub log files.
- Feature
Added `unity editors info ` to display detailed metadata for an installed Editor.
- Feature
Added `unity releases` to list available Unity releases from the release feed.
- Feature
Added `unity modules list ` to display available modules for an Editor version.
- Feature
Added `unity templates list` and `unity templates info ` to list project templates and view template details.
Editor management and installation
- Feature
Added `unity editors add ` to register an existing Editor installation with Unity Hub.
- Feature
Added `unity editors default []` to get or set the default Editor.
- Feature
Added `unity editors install-path []` to get or set the Editor installation path.
- Feature
Added commands to list and install modules for an installed Editor.
- Feature
Added `unity install --dry-run` to preview Editor installations.
- Feature
Added `unity install --force` to reinstall an Editor that is already installed.
- Feature
Added `unity install --resume` to resume interrupted downloads from the local cache.
- Feature
Added `unity install-modules --dry-run` to preview module installations.
- Feature
Added prompts to accept module license agreements before downloading modules.
- Feature
Added `unity cache info` and `unity cache clean` to view and manage the download cache.
Project management
- Feature
Added `unity projects open []` to open a project by using a fuzzy-matched project name when no exact path is provided.
- Feature
Added `unity projects new --template --editor-version ` to create projects non-interactively for scripts and CI workflows.
- Feature
Added `unity projects pin ` and `unity projects unpin ` to manage favorite projects.
- Feature
Added `unity projects export` and `unity projects import` to export and import project lists in JSON format.
- Feature
Added `unity projects info ` to display Editor, module, and cloud information for a project.
- Feature
Added `unity projects upgrade [] --to ` to upgrade a project to a different Editor version.
- Feature
Added `unity projects require ...` to verify that required modules are installed for a project.
- 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
- Feature
Added `unity run` to execute projects in batch mode, stream logs, and return the Editor exit code.
- Feature
Added NDJSON progress output for long-running commands, including `unity build` and `unity projects new` .
Output and integration
- Feature
Added a standardized JSON output envelope that includes `success` , `command` , `data` , `errors` , and `warnings` .
- Feature
Added the `ndjson` output format for streaming progress updates from long-running commands.
- Feature
Added documentation for the `tsv` output format alongside `human` and `json` .
- Feature
Added global `--non-interactive` , `--quiet` , and `--no-banner` options.
- Feature
Added `-y` and `--yes` options for commands that require confirmation.
- Feature
Added `-w` and `--watch` options to keep Editor and project lists updated automatically.
- 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` .
- Feature
Added searchable version selectors for interactive workflows.
- Change
Extended exit code support to include authentication, network, conflict, usage, and command-specific errors.
Platform and extensibility
- Feature
Added `unity [path]` as a shorthand command to launch an Editor with an optional project path.
- Feature
Added plugin discovery for executables named `unity-` , which Unity CLI exposes as `unity ` .
- Feature
Added `unity self-uninstall` to remove the CLI binary, environment files, and stored credentials.
- Feature
Added `unity report-bug` to launch the Unity Hub bug reporter or create a structured bug report.
- Feature
Added `unity upgrade --rollback` to restore the previously installed CLI version.
CLI behavior
- Deprecation
Deprecated `unity implode` in favor of `unity self-uninstall` .
- Improvement
Updated automatic update checks to run in the background without blocking command execution.
- Improvement
Enhanced `unity editors list` to display version aliases, identify the default Editor, and resolve installation paths.
- Improvement
Improved `unity auth login` for remote and headless environments by displaying the sign-in URL before attempting to launch a browser.
- Feature
Added authentication progress events to JSON output so automation tools can capture sign-in URLs programmatically.
Issues fixed
- Fix
Fixed an issue where `unity auth` could fail to start the sign-in flow after a fresh installation.
- 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
- Fix
Fixed an issue on Windows where `unity upgrade` could fail to replace the CLI binary.
- Windows
- Fix
Fixed issues in `unity projects upgrade` related to project name lookups, confirmation prompts, and short version aliases.
- Fix
Fixed an issue where `unity editors info` did not expand short major-version aliases.
- Fix
Fixed issues in `unity install-modules` that prevented correct handling of invalid Editor versions, version aliases, and ambiguous version matches.
- Fix
Fixed an issue where `unity install --dry-run` reported incorrect download sizes when the Editor was already installed.
- Fix
Updated `unity projects require` to accept a project name in addition to a project path.
- Fix
Fixed an issue where the Windows installer could corrupt the system `PATH` .
- Windows
- Fix
Added ASCII fallback support for terminals that do not support Unicode characters.
- Fix
Routed module installation errors to `stderr` to improve scripting and output redirection.
- Fix
Fixed Linux configuration directory inconsistencies between Unity CLI and Unity Hub to keep settings, projects, and Editors synchronized.
- Linux
- Fix
Fixed startup failures in Bun runtimes that do not support `mkdtempDisposable` .
- Fix
Fixed startup failures in packaged Bun binaries caused by an unnecessary runtime dependency on `@vscode/proxy-agent` .