Unity CLI release notes for July 2026

Learn about the Unity CLI releases in July 2026.

Read time 11 minutes

Last updated a day ago

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

1.0.0-beta.3

Release date: July 23, 2026

Interactive shell
- Added persistent command history to
```
unity shell
```
  . Press the Up and Down arrow keys to recall previous commands. History is capped at 1,000 entries, and secret-bearing flag values are masked before they're written to disk.
- Added tab completion to
```
unity shell
```
  for command names, subcommands, option flags, and option values.
- Added session context and defaults to
```
unity shell
```
  :
```
use project <path>
```
  and
```
use org <id>
```
  set an active project or organization for later commands, and
```
set format
```
  ,
```
set verbose
```
  , and
```
set banner
```
  set default global options for the session.
```
unset <key>
```
  clears one setting and
```
context
```
  displays the current state.
- Added
```
unity shell --protocol ndjson
```
  , a machine mode that runs a framed NDJSON request/response protocol over
```
stdio
```
  so automated callers and agents can run many commands in one warm process and read one parseable result per command.
- Updated piped and scripted
```
unity shell
```
  sessions to exit with the code of the first failed command instead of always exiting
```
0
```
  .
Editor and project management
- Added
```
unity editors running
```
  to list running Unity Editor instances with the open project, Editor version, and process ID.
- Added
```
unity projects size [project]
```
  to report a project's on-disk size broken down by top-level folder. Use
```
--all
```
  to summarize every registered project, sorted largest first.
- Added
```
unity projects close [project]
```
  to close the running Editor that has a project open. Use
```
--timeout <seconds>
```
  to bound the graceful wait and
```
--force
```
  to terminate the process when it can't exit.
- Added
```
unity editor module remove
```
  to remove installed modules from an Editor by module ID.
- Added
```
unity install <version> --list-components
```
  as an alias for
```
unity modules list <version>
```
  .
- Added
```
unity run --command <name>
```
  to run a registered
```
[CliCommand]
```
  Editor command headlessly in a single invocation. The CLI starts the Editor in batch mode, runs the command, prints the return value, and shuts the Editor down. Requires the Unity pipeline package.
Automation and CI
- Added
```
--json
```
  as a global shorthand for
```
--format json
```
  on every command.
- Added support for the
```
UNITY_PROJECT_PATH
```
  and
```
UNITY_CLOUD_ORG
```
  environment variables.
- Unified flag names across commands:
```
--project-path
```
  is the canonical flag for a Unity project path and
```
--cloud-org
```
  for a Unity Cloud organization. The previous
```
--project
```
  and
```
--org
```
  spellings keep working as hidden aliases.
- Added non-interactive support to
```
unity bug
```
  through the
```
--title
```
  ,
```
--description
```
  ,
```
--steps
```
  ,
```
--reproducibility
```
  , and
```
--email
```
  options, so you can submit bug reports from scripts and CI.
- Added the
```
UNITY_NO_CONSENT_PROMPT
```
  environment variable to suppress the one-time first-run consent prompt without recording a choice.
- Added terminal-integrated progress reporting through the
```
OSC 9;4
```
  escape sequence. On Windows Terminal, the taskbar icon fills with download and install progress while
```
unity install
```
  runs.
- Updated the CLI to terminate on
```
SIGTERM
```
  with the conventional exit code
```
143
```
  instead of ignoring the signal.
Installation and updates
- Updated
```
install.sh
```
  on Linux to install the binary to
```
~/.local/bin/unity
```
  , which is on
```
PATH
```
  by default on most distributions. Re-running the installer migrates an existing
```
~/.unity
```
  install.
- Added publication of the
```
.deb
```
  and
```
.rpm
```
  packages to Unity's apt and rpm repositories on every beta and general availability (GA) release, so package-managed installs update through the system package manager.
- Added in-place AppImage updates to
```
unity upgrade
```
  , including checksum verification and
```
--rollback
```
  support.
- Updated the background update notice to suggest the owning package manager's exact upgrade command on package-managed installs.
- Fixed the MSIX package never receiving updates because every release rendered the same package version.
- Fixed the Windows install one-liner failing for every user with "The assignment expression is not valid".
Diagnostics and crash reporting
- Added anonymous crash and error reporting through Sentry. Reports contain no IP address or hostname, and home-directory paths and token-like values are scrubbed before sending. Set
```
UNITY_NO_CRASH_REPORT
```
  to disable reporting entirely.
- Expanded the opt-in usage analytics to record which commands run (registered command names only, never arguments, paths, or project names) and the outcomes of key workflows. Nothing is sent when you're opted out, which is the default.
- Updated the "Recent log" section of
```
unity doctor
```
  to render readable log rows instead of raw NDJSON logger lines.
Localization
- Updated
```
unity language
```
  to share the Unity Hub's language catalog, with display names derived from CLDR data.
- Updated
```
unity lang --set
```
  to accept common spellings of a language code: BCP-47 (
```
ja-JP
```
  ), locale (
```
ja_JP
```
  ), bare language (
```
ja
```
  ), or bare region (
```
jp
```
  ).
- Fixed non-English locales missing translations for newer commands, so CLI output renders localized instead of falling back to English.
Security
- Hardened usage errors, the
```
unity bug
```
  log-archive warning, and
```
unity projects add
```
  and
```
unity projects remove
```
  machine output against terminal escape-sequence injection.
- Added GPG signing to the
```
.rpm
```
  packages with the published Unity Technologies ApS key.
Issues fixed
- Fixed
```
unity upgrade
```
  on Windows flashing a console window about a second after the command exits.
- Fixed an invalid
```
--proxy <url>
```
  value being silently ignored. It now fails with a usage error (exit code
```
2
```
  ).
- Fixed editor and module downloads failing with a DNS error when the operating system proxy settings point at an unreachable proxy auto-config (PAC) URL.
- Fixed
```
unity auth login
```
  on Linux without
```
xdg-open
```
  surfacing a confusing error. The command now prints the sign-in URL so you can open it manually. Under Windows Subsystem for Linux (WSL), the CLI now opens URLs through Windows interop.
- Fixed
```
unity open <path> --editor-version <version>
```
  failing with "Not a Unity project" when the project has no
```
ProjectSettings/ProjectVersion.txt
```
  file.
- Fixed
```
unity open
```
  with
```
--editor-version
```
  starting a multi-gigabyte Editor download without asking. A terminal session now confirms before installing, and a non-interactive session fails fast instead.
- Fixed
```
unity status
```
  and
```
unity pipeline list
```
  not detecting a running Editor whose project path contains a space on macOS and Linux.
- Fixed
```
unity command eval
```
  and
```
unity command eval_file
```
  exiting
```
0
```
  when the Editor reported a compilation error. They now exit
```
6
```
  and print the compiler diagnostics.
- Fixed
```
unity mcp
```
  reporting failed
```
eval
```
  tool calls as successful, and fixed
```
unity mcp
```
  breaking permanently after an Editor script recompile.
- Fixed
```
unity editors --installed
```
  stalling for minutes on Windows when antivirus real-time scanning intercepts a freshly installed Editor.
- Fixed an intermittent crash at exit on Windows right after a command completed successfully.
- Fixed
```
unity upgrade
```
  failing with a cross-device link error when the system temporary directory is on a different filesystem than the install directory.
- Fixed
```
unity projects create
```
  handing a corrupt template archive to the Editor. Template downloads are now verified against their published checksum.
- Fixed
```
unity run --command
```
  launching a second Editor on Windows when the project path differed only by letter case.
- Fixed the
```
.deb
```
  package failing to install on minimal Debian and Ubuntu systems by declaring a dependency on
```
ca-certificates
```
  , and fixed the Unity licensing client never installing on Linux systems without the
```
unzip
```
  utility.
- Fixed opted-out runs sending a single anonymous analytics request in some commands. Consent off now means zero analytics requests.
- Fixed
```
unity analytics opt-in
```
  and
```
unity analytics opt-out
```
  not permanently answering the first-run consent prompt when run from a script.

1.0.0-beta.2

Release date: July 16, 2026

Interactive shell
- Added
```
unity shell
```
  , an interactive session that boots the CLI once and runs many commands in the same warm process. Enter any command without the
```
unity
```
  prefix, and leave with
```
exit
```
  ,
```
quit
```
  , or Ctrl+D. Interactive prompts work inside the shell, and a change made by one command is visible to the next.
Proxy diagnostics
- Added
```
unity diagnose proxy
```
  to print a redacted, paste-safe proxy diagnostic report: the resolved proxy and its source, PAC configuration, CA bundle, and credential-store and Kerberos checks.
- Added the global
```
--log-proxy
```
  flag (or
```
UNITY_LOG_PROXY=1
```
  ) to log one redacted entry per outbound request for reproducing proxy issues.
- Fixed part of the CLI's HTTPS traffic bypassing the configured proxy. Sign-in, template and release lookups,
```
unity bug
```
  , and
```
unity upgrade
```
  traffic now route through the same proxy stack as downloads, and
```
--proxy-disable
```
  now forces a direct connection.
Unity pipeline package
- Added
```
unity pipeline upgrade
```
  to upgrade the Unity pipeline package in a project when the registry has a newer version.
- Added
```
unity pipeline list-versions
```
  to list every published version of the package, and
```
unity pipeline install --package-version <version>
```
  to install a specific version.
- Updated
```
unity pipeline list
```
  to show each project's installed package version and flag when a newer version is available.
- Added
```
unity list
```
  , a discovery command that queries the connected Unity Editor and prints every registered tool with its name, description, group, and parameter schema.
Editor and module installation
- Added
```
--reinstall
```
  and
```
-f, --force
```
  to
```
unity install-modules
```
  to repair modules that are already installed.
- Added automatic retries for module downloads that fail intermittently. Tune or disable retries with
```
--retries <n>
```
  or
```
UNITY_INSTALL_RETRIES
```
  .
- Added
```
--no-elevate
```
  (or
```
UNITY_NO_ELEVATE=1
```
  ) on Windows to skip the elevated (UAC) install helper for user-writable install locations and CI shells.
- Updated
```
unity install
```
  and
```
unity install-modules
```
  to continue installing the remaining modules when one fails, and to report a per-item result for each Editor and module on both success and failure.
- Added a desktop entry for installed Editors on Linux, so a launched Editor shows the Unity name and icon in the taskbar.
Diagnostics
- Added environment health checks to
```
unity doctor
```
  : whether the
```
unity
```
  binary's directory is on
```
PATH
```
  , whether multiple
```
unity
```
  binaries shadow each other, and whether Windows long-path support is enabled.
Installation and updates
- Updated
```
unity upgrade
```
  to detect how the CLI was installed. On a package-manager install, it points you at the owning manager instead of replacing the binary in place.
- Added GPG signing and AppImage-native update information to the Linux AppImage, so third-party updaters can check for and apply CLI updates.
CLI behavior
- Added "Did you mean" suggestions for unknown commands that look like a typo of a real one.
- Updated command modules to load only when their command runs, reducing startup time on every invocation.
- Removed
```
--instance <host:port>
```
  from
```
unity command
```
  and
```
unity mcp
```
  . The CLI now always discovers running Editors itself; run from the project directory or pass
```
--project-path
```
  to target one.
- Removed the regional display languages Spanish (Latin America), French (Canada), and Portuguese (Portugal) from
```
unity language
```
  . Spanish, French, and Portuguese (Brazil) remain available.
- Updated the first-run consent prompt to require an explicit
```
y
```
  or
```
n
```
  answer.
Security
- Hardened the Editor and module installers against command injection through the configured install location.
- Updated
```
unity hub install
```
  to verify that the downloaded installer is signed by Unity specifically, instead of accepting any validly signed binary.
- Extended escape-sequence hardening to more output surfaces, including
```
unity projects list
```
  and the detail views.
Issues fixed
- Fixed the
```
lts
```
  version alias resolving to the newest Supported-stream release instead of the newest Long Term Support (LTS) release.
- Fixed command hints showing literal markdown backticks. Commands now render in cyan on color terminals and as plain text elsewhere.
- Fixed the CLI requiring the Microsoft Visual C++ Redistributable on Windows.
- Fixed Unity 2021 and 2022 Editors failing to start when launched through the CLI on Windows.
- Fixed the
```
unity license
```
  commands not recognizing service-account sessions, and fixed
```
unity license return
```
  not returning serial-activated licenses.
- Fixed file sizes printing a literal
```
undefined
```
  where the unit belongs.
- Fixed installing the Visual Studio module opening the interactive Visual Studio Installer on Editor versions whose release manifest omits the install command.
- Fixed
```
unity templates list
```
  and
```
unity templates info
```
  silently falling back to cached template data when the template registry is unreachable. The CLI now prints a warning when it shows cached data.
- Fixed concurrent module installs corrupting the Editor's module state or failing with misleading permission errors.
- Fixed the install scripts failing on systems without a shell startup file, and fixed the Windows install script failing to parse under Windows PowerShell 5.1 when saved to disk.
- Fixed authentication failures in the
```
unity cloud
```
  commands exiting with code
```
6
```
  instead of
```
3
```
  , and aligned operational failures in the cloud and auth commands on exit code
```
6
```
  .
- Fixed interrupted builds exiting with a generic
```
1
```
  . Interrupting
```
unity build
```
  now exits
```
130
```
  for Ctrl+C and
```
143
```
  for
```
SIGTERM
```
  .
- Fixed
```
unity upgrade
```
  failing with a 404 error when the Unity Hub ran in a non-production environment on the same machine.

Unity command-line interface (CLI)

Unity Pipeline

Unity Hub

Unity command-line interface (CLI)

Unity CLI release notes for July 2026

1.0.0-beta.3

1.0.0-beta.2