Unity CLI release notes for June 2026

Learn about the Unity CLI releases in June 2026.

Read time 9 minutes

Last updated a day ago

This page contains the release notes for the Unity CLI versions released in June 2026, from newest to oldest.

1.0.0-beta.1

Release date: June 30, 2026

The first 1.0 beta of the Unity CLI. This release marks the move to 1.0 versioning and rolls up the functionality shipped across the 0.1.0 betas.

Issues fixed
- The CLI no longer logs your OAuth access token or Hub session ID in plaintext. Editor-launch commands previously wrote them to the log file that
```
unity logs
```
  ,
```
unity doctor
```
  , and
```
unity bug
```
  read; they're now redacted.
- Fixed detail commands printing nothing under
```
--format tsv
```
  and
```
--format ndjson
```
  , including
```
unity editors info
```
  ,
```
unity config update-check
```
  ,
```
unity pipeline install
```
  ,
```
unity license activate
```
  , and
```
unity upgrade --dry-run
```
  .
- Fixed
```
unity run
```
  and
```
unity test
```
  mixing the Editor's batch-mode output into machine-readable output. Under
```
--format json
```
  and
```
--format ndjson
```
  , the Editor's output goes to
```
stderr
```
  so the result is the only thing on
```
stdout
```
  .
- Fixed
```
unity projects list
```
  dropping its column flags (
```
-v
```
  ,
```
--cloud
```
  ,
```
--editor-version
```
  ,
```
--vcs
```
  ,
```
-m
```
  ,
```
--pipeline
```
  ) when piped.
- Fixed
```
unity templates create
```
  flattening dots in the stored template name, which made later lookups by name fail.
- Fixed
```
unity editors --installed
```
  hanging on Windows right after an install when antivirus scanning or a file lock delayed reading the Editor executable.
- Fixed invalid
```
unity upgrade --target
```
  and
```
--channel
```
  values exiting with a generic error code instead of the standard usage-error code.

0.1.0-beta.8

Release date: June 25, 2026

AI agent integration
- Added
```
unity mcp
```
  to start a Model Context Protocol (MCP) server, built into the
```
unity
```
  binary, that exposes the commands of a connected Unity Editor as MCP tools. AI agent clients connect over
```
stdio
```
  and can list and run those commands.
- Added
```
unity mcp configure <client>
```
  to register the Unity MCP server in an AI agent's configuration in one step, for 16 supported clients including Claude, Claude Code, Cursor, and VS Code. Only the Unity entry is written; every other key in the file is preserved.
Editor management
- Added
```
unity editors upgrade [editor]
```
  to upgrade an installed Editor to the newest official patch in its same
```
major.minor
```
  line, carrying the Editor's installed modules over to the new patch. Supports
```
--all
```
  ,
```
--dry-run
```
  ,
```
--replace
```
  , and module and architecture flags.
- Added an explicit
```
unity editors list
```
  subcommand, matching the
```
list
```
  verb used by other command groups.
- Added an "Upgrade to" column to
```
unity editors list --installed
```
  that flags installed Editors with a newer patch available in their line.
CLI behavior
- Updated
```
unity bug
```
  to collect the same diagnostic system information as the Unity Hub bug reporter, including GPU details.
- Updated the Unity CLI and the Unity Hub to store their sign-in credentials separately, so each can stay signed in as a different account.
- Updated
```
unity projects clone
```
  to download Git LFS objects after cloning.
- Added a background check for a newer
```
unity
```
  version with an unobtrusive update notice. Turn it off with
```
unity config update-check off
```
  or the
```
UNITY_NO_UPDATE_CHECK
```
  environment variable.
Issues fixed
- Fixed
```
unity projects clone
```
  storing your Git access token in the cloned repository's
```
.git/config
```
  .
- Fixed the CLI hanging at exit after a command finished printing its output.
- Fixed the bundled Unity licensing client failing its signature check on macOS and being re-downloaded on every run.
- Fixed
```
unity releases --limit
```
  not limiting the number of releases returned.
- Fixed
```
unity analytics
```
  ,
```
unity language
```
  , and
```
unity config proxy
```
  printing nothing under
```
--format tsv
```
  and
```
--format ndjson
```
  .
Removed
- Removed the deprecated
```
unity implode
```
  alias. Use
```
unity self-uninstall
```
  instead.

0.1.0-beta.7

Release date: June 16, 2026

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.

0.1.0-beta.6

Release date: June 04, 2026

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.

Unity command-line interface (CLI)

Unity Pipeline

Unity Hub