30 documented changes.

Version
1.0.0-beta.11
Released
Sep 22, 2026
Product
Unity CLI
Unity CLI release notes

Unity CLI 1.0.0-beta.11

Official notes

Security

  1. Security

    `unity bug` now redacts the log files it collects before uploading them, masking home-directory paths, user names, tokens, and email addresses. Files you add with `--attachments` are uploaded as-is.

  2. Security

    On Linux, extracting a `.pkg` module no longer writes through an existing symlink, so an archive can't place files outside the install folder.

    • Linux
  3. Security

    On Linux, the hardened auth-broker tier now refuses to start when its token store or polkit policy is misconfigured, instead of serving tokens without the isolation it depends on.

    • Linux

Added

  1. Feature

    `unity recompile` checks that your scripts compile in a running Editor, without a full build. It lists each compiler error with its file and line, and exits 0 on success, 6 on compile errors, or 7 when no Editor responds.

  2. Feature

    `unity docs ` opens the Unity documentation for a class or topic, matched to your project's Unity version. Use `--manual` for the Manual instead of the Scripting API, `--search` for search results, `--url` to print the address, or `--editor-version` to choose a version.

  3. Feature

    `unity assets import ` imports a `.unitypackage` into a project. It checks the package and the project before starting the Editor, and prints the Editor's error summary when the import fails.

  4. Feature

    `unity assets export --output ` exports assets and folders to a `.unitypackage` . Dependencies are included unless you pass `--no-dependencies` .

  5. Feature

    `unity cloud org create ` creates a Unity Cloud organization. Pass `--industry` or pick one when prompted, and add `--set-default` to switch to the new organization.

  6. Feature

    `unity pipeline cloud-build` and `unity pipeline automation` list and inspect Unity Build Automation targets and builds, and Unity Pipeline Automation apps, pipelines, and jobs. These commands are read-only and mask secret values in their output.

  7. Feature

    `unity mcp configure --server issue-tracker` adds the Unity Issue Tracker MCP server to your AI client. Clients that can't use a remote server are skipped with a warning.

  8. Feature

    `unity run --log-file ` writes the Editor log to a file, including with `--command` , and streams it to the console like `unity build` . Add `--no-tail` to write the file only.

  9. Feature

    `unity editors prune` now reports registered editors whose install folder is gone, and `--remove-missing` removes them from your editor list.

  10. Feature

    `install.sh` and `install.ps1` now install the latest beta when you don't choose a release channel, until the CLI has a stable release.

Changed

  1. Change

    Opt-in analytics and the anonymous usage count now record your project's Unity version, and opt-in analytics also record the editor version a command used. The anonymous usage count also notes whether the CLI ran from a terminal, an automated agent, or CI, and still carries no account, machine identifier, or file path.

Fixed

  1. Fix

    When the Editor offers a matching status command for a job, such as `build_status` for `build` , `unity job wait` now says the job's command was dispatched and names that status command. It no longer reports success while the real work is still running.

  2. Fix

    `unity build run` now serves compressed WebGL builds with the correct headers, so they load in the browser. For browsers that don't accept the compression over plain HTTP, such as Firefox, it decompresses files as it serves them.

  3. Fix

    Usage errors, such as an unknown option or a missing value, now follow `--format json` and `--format ndjson` and return the standard result envelope with the `INVALID_COMMAND_ARGS` code. The exit code is still 2.

  4. Fix

    `unity open` no longer leaves Unity Connect half-configured in a project linked to Unity Cloud. This caused "Unity Connect configuration is invalid" errors, an Asset Store "Open in Browser" button that did nothing, and high Editor CPU use.

  5. Removal

    On Windows, when `unity uninstall` can't delete the editor folder, it now names the folder and tells you to close the Editor and check your permissions, instead of reporting an invalid uninstaller. JSON output uses the new `UNINSTALL_REMOVAL_FAILED` error code, and read-only files no longer block removal.

    • Windows
  6. Fix

    On Windows, `unity self-update` no longer fails with "Unable to schedule the update helper (exit status 3)" when the folder you ran it from is deleted, renamed, or unmounted before the update completes.

    • Windows
  7. Fix

    Running `install.ps1` through `irm | iex` no longer closes your PowerShell window when the install fails.

  8. Fix

    `install.sh` now works on machines without `jq` , including stock macOS. It also reports a clear error when the release manifest is damaged, such as when a captive portal or proxy replaces it.

    • macOS
  9. Fix

    On Linux, module installs no longer fail with a checksum mismatch caused by incorrect checksums in Unity's release data. Until that data is fixed, Linux module downloads skip checksum verification, as Unity Hub does.

    • Linux
  10. Fix

    Network requests, including those through a proxy, no longer fail with "address incompatible with the selected protocol" when a host has several addresses or a local proxy listens only on IPv6 ( `[::1]` ).

  11. Fix

    On Windows, when a proxy auto-config (PAC) result lists a proxy per scheme, such as `http=proxy1:8080;https=proxy2:8443` , each request now uses the proxy for its own scheme.

    • Windows
  12. Fix

    `unity pipeline install` and `unity pipeline upgrade` no longer crash when `Packages/manifest.json` lists `com.unity.pipeline` more than once.

  13. Fix

    `unity projects` commands that change your project list now use the same database engine as Unity Hub. This fixes a rare write conflict on Linux, and a spurious lock error when the CLI and the Hub create the list at the same time.

    • Linux
  14. Fix

    `cli-log.json` no longer gets corrupted lines when two `unity` commands write to it at the same time.

  15. Fix

    `unity templates list` now lists custom templates in the same order as Unity Hub.

  16. Fix

    `unity status` and the Pipeline connection error now recognize an OpenAI Codex sandbox on Windows, as they already did on macOS.

    • Windows
    • macOS

Pick your Unity version

Unity Releases compares releases against the version your project is on. Picking it now keeps Compare versions focused on what changes between where you are and where you might be going.