Unity command-line interface (CLI) release notes

Learn about the latest releases, features, improvements and fixes for Unity CLI.

Read time 10 minutes

Last updated 4 days ago

June 16, 2026

0.1.0-beta.7

Licensing
- Added
```
unity license
```
  (
```
unity license list
```
  ) to display active Unity licenses on the current machine, including product, license type, organization, and expiration date.
- Added
```
unity license status
```
  to display licensing status, sign-in state, and active license information.
- Added
```
unity license activate
```
  to activate licenses through serial, Personal, floating, offline file, or offline request workflows.
- Added
```
unity license return
```
  to return active licenses and free associated seats.
- Added
```
unity license server status
```
  and
```
unity license server list
```
  to display floating license server status and availability.
Project management and source control
- Added
```
unity projects clone
```
  to clone and register Unity projects from GitHub, GitLab, and Unity Version Control repositories.
- Added support for branch, commit, and changeset selection during project cloning.
- Added
```
unity projects link vcs
```
  and
```
unity projects unlink vcs
```
  to connect or disconnect projects from source control repositories.
- Added source control options to
```
unity projects create
```
  and
```
unity projects link vcs
```
  , including repository visibility, default branch, Git LFS, and Unity Version Control region settings.
Hub and Editor management
- Added
```
unity hub install
```
  to install Unity Hub.
- Added support for architecture selection, silent installation, version selection, and installer signature verification.
- Added
```
unity editors path <version>
```
  to display the installation path of an installed Editor.
Build automation
- Added Android signing options to
```
unity build
```
  , including keystore, signing key, version code, symbol generation, and target SDK configuration.
- Added support for exporting Android builds as APK, Android App Bundle (AAB), or Android Studio projects.
- Added validation for Android signing parameters and warnings when sensitive information is provided through command-line arguments.
Testing
- Added
```
unity test [project]
```
  to run Edit Mode and Play Mode tests through the Unity Editor test runner in batch mode.
- Added support for NUnit XML test reports through the
```
--output
```
  option. The default output file is
```
test-results.xml
```
  .
- Added support for
```
--mode
```
  ,
```
--filter
```
  ,
```
--editor-version
```
  ,
```
--editor-path
```
  ,
```
--architecture
```
  ,
```
--allow-install
```
  , and
```
--timeout
```
  options.
- Added support for the
```
UNITY_TEST_TIMEOUT
```
  environment variable.
- Added exit code
```
6
```
  when test execution completes but one or more tests fail.
CLI behavior
- Added a dedicated
```
cli-log.json
```
  log file for Unity CLI.
- Updated
```
unity logs
```
  ,
```
unity bug
```
  , and
```
unity doctor
```
  to use CLI-specific logs.
- Added a branded Unity header for interactive CLI entry points, including
```
unity
```
  ,
```
unity help
```
  , and
```
unity --help
```
  .
- Updated the CLI to display usage information and return exit code
```
0
```
  when users run
```
unity
```
  without arguments.
Issues fixed
- Fixed an issue where module installers always used the same installation command instead of honoring module-specific installation parameters.
- Fixed an issue where
```
--format ndjson
```
  was not supported by
```
unity projects list
```
  and
```
unity modules list
```
  .
- Fixed an issue where
```
unity bug
```
  could fail with an HTTP 400 error.
- Fixed table output that could truncate identifier columns when terminal width was limited.
- Hardened terminal output against control-character and escape-sequence injection from server-provided values.
- Fixed session-state reporting in
```
unity doctor
```
  and
```
unity cloud status
```
  to match
```
unity auth status
```
  .
- Fixed architecture detection on Windows Arm64 systems running x64 emulation.

June 04, 2026

0.1.0-beta.6

Editor scripting and status
- Added
```
unity eval '<expr>'
```
  to evaluate C# expressions against a connected Unity Editor through the Pipeline server.
- Added support for human-readable, JSON, TSV, and NDJSON output formats, timeouts, and instance targeting in
```
unity eval
```
  .
- Added
```
unity status
```
  to display the status of connected Unity Editors, including port, project path, Unity version, process ID, and connectivity.
- Added filtering options for Editor instances and support for automation workflows through structured output and exit codes.
Custom templates
- Added
```
unity templates create
```
  to package existing Unity projects as reusable custom templates.
- Added
```
unity templates edit
```
  to update custom template metadata.
- Added
```
unity templates delete
```
  to remove custom templates.
- Added
```
unity templates location
```
  to view, configure, or reset the custom template storage location.
- Added support for filtering templates by type in
```
unity templates list
```
  .
Unity Cloud
- Added
```
unity cloud status
```
  to display cloud sign-in status and the active organization.
- Added commands to list, select, and manage Unity Cloud organizations.
- Added
```
unity cloud project list
```
  to display Unity Cloud projects in the active organization.
Project management
- Added
```
--cloud
```
  support to
```
unity projects create
```
  to create and link a Unity Cloud project during project creation.
- Added
```
--cloud-project
```
  support to link a project to an existing Unity Cloud project.
- Added
```
unity projects link cloud
```
  and
```
unity projects unlink cloud
```
  to manage Unity Cloud project associations.
- Added support for creating projects from
```
.tgz
```
  archives and directory paths in addition to registered template IDs.
Build versioning
- Added
```
--versioning-strategy
```
  and
```
--build-version
```
  options to
```
unity build
```
  .
- Added support for deriving build versions from Git tags and repository history.
- Added validation that prevents builds from using a modified working tree unless
```
--allow-dirty-build
```
  is specified.
Authentication and analytics
- Added shared authentication between Unity CLI and Unity Hub through the operating system keyring.
- Added automatic migration of existing Unity Hub sessions to keyring-based storage.
- Added
```
unity analytics opt-in
```
  ,
```
unity analytics opt-out
```
  , and
```
unity analytics status
```
  commands to manage telemetry preferences.
- Added a first-run consent prompt for telemetry collection.
- Added support for shared telemetry preferences between Unity CLI and Unity Hub.
- Set telemetry collection to opt out by default.
Networking and proxy support
- Added support for HTTP, HTTPS, SOCKS, and PAC proxies.
- Added support for authenticated proxies, including Kerberos and SPNEGO.
- Added proxy configuration precedence through command-line arguments, environment variables, stored settings, and operating system settings.
- Added
```
unity config proxy
```
  to view, configure, or clear proxy settings.
- Added proxy diagnostics to
```
unity doctor
```
  and
```
unity env
```
  .
- Added
```
--proxy-disable
```
  to bypass proxy settings for a single command invocation.
CLI behavior
- Standardized command naming to
```
unity <command>
```
  across the CLI, documentation, and shell completions.
- Updated
```
unity auth status
```
  to report actual session state through the Session Service.
- Improved Windows upgrade messaging to provide clearer post-upgrade guidance.
Issues fixed
- Fixed an issue where
```
unity install
```
  could become stuck when resuming a corrupted partial download.
- Fixed an issue where concurrent
```
unity install
```
  commands could corrupt shared installation data.
- Fixed an issue on Windows where Visual Studio modules could incorrectly appear as already installed.
- Fixed an issue where
```
unity auth logout
```
  did not reliably remove stored credentials.
- Fixed interactive prompts on Windows for module installation confirmation and architecture selection.
- Fixed an issue where
```
unity open
```
  did not correctly forward
```
--args
```
  to the Unity Editor on Windows.
- Fixed validation and error handling for
```
unity --instance host:port
```
  .
- Fixed support for
```
--format tsv
```
  and
```
--format ndjson
```
  in
```
unity editors
```
  .
- Fixed an issue where unattended installations using
```
unity install --accept-eula --non-interactive
```
  could fail.
- Fixed template command error handling when no default Editor is configured.
- Fixed structured output from
```
unity status
```
  when no reachable Editor instances are available.
- Fixed JSON output formatting inconsistencies for command failures.
- Fixed JSON output handling for validation errors.
- Fixed command execution flow to ensure handlers exit correctly after failures.

May 21, 2026

0.1.0-beta.5

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 <path>
```
  .
- 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.

May 07, 2026

0.1.0-beta.4

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 <bash|zsh|fish|powershell>
```
  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 <version>
```
  to display detailed metadata for an installed Editor.
- Added
```
unity releases
```
  to list available Unity releases from the release feed.
- Added
```
unity modules list <version>
```
  to display available modules for an Editor version.
- Added
```
unity templates list
```
  and
```
unity templates info <id>
```
  to list project templates and view template details.
Editor management and installation
- Added
```
unity editors add <path>
```
  to register an existing Editor installation with Unity Hub.
- Added
```
unity editors default [<version>]
```
  to get or set the default Editor.
- Added
```
unity editors install-path [<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 [<query>]
```
  to open a project by using a fuzzy-matched project name when no exact path is provided.
- Added
```
unity projects new <name> --template <id> --editor-version <version>
```
  to create projects non-interactively for scripts and CI workflows.
- Added
```
unity projects pin <pattern>
```
  and
```
unity projects unpin <pattern>
```
  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 <path>
```
  to display Editor, module, and cloud information for a project.
- Added
```
unity projects upgrade [<path-or-name>] --to <version>
```
  to upgrade a project to a different Editor version.
- Added
```
unity projects require <module>...
```
  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 <version> [path]
```
  as a shorthand command to launch an Editor with an optional project path.
- Added plugin discovery for executables named
```
unity-<name>
```
  , which Unity CLI exposes as
```
unity <name>
```
  .
- 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
```
  .

April 24, 2026

0.1.0-beta.3

Fixed an issue where
```
unity install
```
,
```
unity install-modules
```
, and
```
unity auth
```
failed with a service resolution error after a fresh installation.
Fixed an issue on Linux where the CLI used
```
~/.local/share/unityhub
```
for Hub data. The CLI now reads and writes Hub data in
```
~/.config/unityhub
```
, which matches the Unity Hub location and keeps projects, Editors, and preferences synchronized between the CLI and Unity Hub.

April 23, 2026

0.1.0-beta.2

Added
```
unity implode
```
to uninstall the CLI. This command removes the installed binary and environment files and clears stored credentials from the operating system keyring. In non-interactive shells, the command requires the
```
--yes
```
flag and only works on a CLI installed using the official installer.
Added
```
unity projects create
```
to create a Unity project from the CLI.
Added
```
unity changelog
```
to display the release notes for the installed CLI.
Added
```
unity upgrade --changelog
```
to preview release notes for an update without installing it.
Added
```
unity upgrade --target <version>
```
to upgrade to a specific published version instead of the latest version in your channel.
Added interactive
```
unity upgrade
```
which shows release note previews for the target version before confirmation.

April 04, 2026

0.1.0-beta.1

First public beta release of Unity CLI. This release provides a single executable for macOS, Linux, and Windows on x64 and Arm64 architectures. Install Unity CLI by using

install.sh

install.ps1

Authentication: Added
```
unity auth
```
with secure token storage in the operating system keychain:
- Keychain on macOS
- Credential Manager on Windows
- libsecret on Linux
Editor management: Added the following commands:
- ```
unity editors
```
  ,
```
unity install
```
  ,
```
unity uninstall
```
  ,
```
unity install-modules
```
  , and
```
unity install-path
```
- Supports Editor version aliases
- Installs Editor versions with or without a changeset
Project management: Added the following commands:
- ```
unity projects
```
  to list, add, remove, and create projects
- ```
unity open <path>
```
  to open a project
- Supports bare-path syntax, such as
```
unity ./MyProject
```
Upgrade management: Added
```
unity upgrade
```
. Automatically selects the appropriate update channel based on the installed version (stable or prerelease).
Localization: Added the
```
unity language
```
command.
- Added support for 13 locales
Output formats: Added the global
```
--format <human|json|tsv>
```
flag for machine-readable output. Suppresses the interactive banner for JSON and TSV output and when output is piped.
Verifiable downloads: Added SHA-256 checksums for all platform binaries

Documentation

Development

User Acquisition

Monetization

Industry