--- title: Unity CLI release notes for May 2026 product: Unity command-line interface (CLI) canonical: https://docs.unity.com/en-us/unity-cli/release-notes/2026/may last_updated: 2026-11-12 generated_at: 2026-11-14T04:32:22.519Z locale: en-us --- # Unity CLI release notes for May 2026 > Learn about the Unity CLI releases in May 2026. This page contains the release notes for the Unity CLI versions released in May 2026, from newest to oldest. ## 0.1.0-beta.5 **Release date:** May 21, 2026 * **Service account authentication** * Added support for Unity service account authentication in `unity auth login`. * Added support for automatic bearer token generation when `UNITY_SERVICE_ACCOUNT_ID` and `UNITY_SERVICE_ACCOUNT_SECRET` are set. * Added support for unattended authentication workflows in CI environments and automation scenarios. * Updated `unity auth logout` to clear both service account and OAuth credentials. * Added a warning when only one of `UNITY_SERVICE_ACCOUNT_ID` or `UNITY_SERVICE_ACCOUNT_SECRET` is configured. * **Unity Pipeline** * Added `unity pipeline install` (`unity pipe install`) to install the Unity Pipeline package into a Unity project. * Added automatic project detection for pipeline installation and support for the `--project-path` and `--ssh` options. * Added `unity pipeline list` (`unity pipe list`) to display Unity Editor instances and Pipeline package status. * Added `unity command` (`unity cmd`, `unity request`) to execute commands against connected Unity Editor instances or list available commands. * **Editor installation and management** * Enhanced `unity install --resume` to recover orphaned partial downloads that result from interrupted installations. * Added module discovery support with `unity install` and `unity install-modules` for Editors registered with `unity editors add `. * Added support for module discovery on Editors that Unity Hub did not install. * **Output and integration** * Added a `phase: 'download' | 'install'` field to NDJSON progress output for `unity install` and `unity install-modules` to distinguish download and installation phases. * Improved NDJSON output and CLI progress reporting by grouping module progress under the parent Editor installation. * **Error handling** * Standardized CLI error messages across commands. * Improved separation between user-actionable errors and internal errors. * Updated exit code behavior to align with the exit-code contract introduced in version `0.1.0-beta.4`. * **Issues fixed** * Fixed an issue where NDJSON progress output for `unity install` reset progress from 100 percent to 0 percent during installation. * Fixed an issue where `unity editors --installed` could hang indefinitely when the release feed was unavailable, such as on split-tunnel VPN connections. * Fixed an issue where `unity install --resume` could hang when the target Editor was already installed. * Fixed orphaned download discovery to detect partial downloads under all supported interruption scenarios. * Fixed an issue on Windows where `unity install` could incorrectly report that an Editor was already installed immediately after uninstalling it. * Fixed an issue where `unity install -m` and `unity install-modules -m` did not correctly process multiple space-separated module values after a single `-m` flag. ## 0.1.0-beta.4 **Release date:** May 07, 2026 A major release that adds core workflow commands for diagnostics, Editor management, project management, and automation. * **Diagnostics and inspection** * 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. * Added `unity completion ` to generate shell completion scripts. * Added `unity env` to display environment variables used by Unity CLI and Unity Hub. * Added `unity logs` to view and follow Unity Hub log files. * Added `unity editors info ` to display detailed metadata for an installed Editor. * Added `unity releases` to list available Unity releases from the release feed. * Added `unity modules list ` to display available modules for an Editor version. * Added `unity templates list` and `unity templates info ` to list project templates and view template details. * **Editor management and installation** * Added `unity editors add ` to register an existing Editor installation with Unity Hub. * Added `unity editors default []` to get or set the default Editor. * Added `unity editors install-path []` to get or set the Editor installation path. * Added commands to list and install modules for an installed Editor. * Added `unity install --dry-run` to preview Editor installations. * Added `unity install --force` to reinstall an Editor that is already installed. * Added `unity install --resume` to resume interrupted downloads from the local cache. * Added `unity install-modules --dry-run` to preview module installations. * Added prompts to accept module license agreements before downloading modules. * Added `unity cache info` and `unity cache clean` to view and manage the download cache. * **Project management** * Added `unity projects open []` to open a project by using a fuzzy-matched project name when no exact path is provided. * Added `unity projects new --template --editor-version ` to create projects non-interactively for scripts and CI workflows. * Added `unity projects pin ` and `unity projects unpin ` to manage favorite projects. * Added `unity projects export` and `unity projects import` to export and import project lists in JSON format. * Added `unity projects info ` to display Editor, module, and cloud information for a project. * Added `unity projects upgrade [] --to ` to upgrade a project to a different Editor version. * Added `unity projects require ...` to verify that required modules are installed for a project. * 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** * Added `unity run` to execute projects in batch mode, stream logs, and return the Editor exit code. * Added NDJSON progress output for long-running commands, including `unity build` and `unity projects new`. * **Output and integration** * Added a standardized JSON output envelope that includes `success`, `command`, `data`, `errors`, and `warnings`. * Added the `ndjson` output format for streaming progress updates from long-running commands. * Added documentation for the `tsv` output format alongside `human` and `json`. * Added global `--non-interactive`, `--quiet`, and `--no-banner` options. * Added `-y` and `--yes` options for commands that require confirmation. * Added `-w` and `--watch` options to keep Editor and project lists updated automatically. * 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`. * Added searchable version selectors for interactive workflows. * Extended exit code support to include authentication, network, conflict, usage, and command-specific errors. * **Platform and extensibility** * Added `unity [path]` as a shorthand command to launch an Editor with an optional project path. * Added plugin discovery for executables named `unity-`, which Unity CLI exposes as `unity `. * Added `unity self-uninstall` to remove the CLI binary, environment files, and stored credentials. * Added `unity report-bug` to launch the Unity Hub bug reporter or create a structured bug report. * Added `unity upgrade --rollback` to restore the previously installed CLI version. * **CLI behavior** * Deprecated `unity implode` in favor of `unity self-uninstall`. * Updated automatic update checks to run in the background without blocking command execution. * Enhanced `unity editors list` to display version aliases, identify the default Editor, and resolve installation paths. * Improved `unity auth login` for remote and headless environments by displaying the sign-in URL before attempting to launch a browser. * Added authentication progress events to JSON output so automation tools can capture sign-in URLs programmatically. * **Issues fixed** * Fixed an issue where `unity auth` could fail to start the sign-in flow after a fresh installation. * Fixed an issue on Windows where `unity auth` removed query parameters from the OAuth callback URL, which could prevent sign-in from completing. * Fixed an issue on Windows where `unity upgrade` could fail to replace the CLI binary. * Fixed issues in `unity projects upgrade` related to project name lookups, confirmation prompts, and short version aliases. * Fixed an issue where `unity editors info` did not expand short major-version aliases. * Fixed issues in `unity install-modules` that prevented correct handling of invalid Editor versions, version aliases, and ambiguous version matches. * Fixed an issue where `unity install --dry-run` reported incorrect download sizes when the Editor was already installed. * Updated `unity projects require` to accept a project name in addition to a project path. * Fixed an issue where the Windows installer could corrupt the system `PATH`. * Added ASCII fallback support for terminals that do not support Unicode characters. * Routed module installation errors to `stderr` to improve scripting and output redirection. * Fixed Linux configuration directory inconsistencies between Unity CLI and Unity Hub to keep settings, projects, and Editors synchronized. * Fixed startup failures in Bun runtimes that do not support `mkdtempDisposable`. * Fixed startup failures in packaged Bun binaries caused by an unnecessary runtime dependency on `@vscode/proxy-agent`.