33 documented changes.

Version
1.0.1
Released
Nov 16, 2026
Product
Unity CLI
Unity CLI release notes

Unity CLI 1.0.1

Official notes

Security

  1. Security

    `unity projects unlink vcs` no longer prints the username or password in a removed remote's URL, whatever its scheme. Only `http` and `https` URLs had them removed before.

Added

  1. Feature

    `unity mcp --tools` and `--exclude-tools` accept a whole Editor command group by name, such as `--tools editor_playmode` , to allow or hide every command in that group.

Changed

  1. Change

    `unity logs --format ndjson` now ends with the same paging fields as other listings ( `total` , `nextPage` , `partial` ) in its final result line.

  2. Change

    The `new-unity-project` agent skill now ends project creation with a playable game instead of a lit empty scene: after the first commit it builds at least one playable loop (a goal, a way to win or lose, and a restart, or the shape you asked for, such as a sandbox) and scores it with the `craft-game-floors` done gate, before the publish step.

  3. Change

    `unity analytics status` , `unity skill install` , the summary lines of `unity projects report` and the signed-out message of `unity cloud` now print their intro, tip and refusal lines on stderr instead of stdout, so `--quiet` no longer changes what stdout holds. Under `--format github` the signed-out `unity cloud` message is now an error annotation on stdout.

  4. Change

    `unity commands --format json` and `--format ndjson` now give every command a `path` key, the full command path such as `analytics opt-in` , so the `path` column of `--format tsv` names a key in the JSON output.

  5. Change

    `--format tsv` (the default when output is piped) now starts with a `key` and `value` header row, then one row per field, for `unity version` , `unity --version --format tsv` , `unity config get` , `set` , `unset` , `path` , `resolve` and `update-check` , `unity cache key` , `unity language` , and `unity upgrade` with `--check` or `--dry-run` . The field names are the ones `--json` uses.

  6. Change

    `unity upgrade --format ndjson` with `--check` or `--dry-run` , or when the CLI is already up to date, prints one result frame with the same fields as `--json` , where it used to print a tab-separated row.

  7. Change

    `--format tsv` (the default when output is piped) now starts with a header row for `unity editors` , `unity cloud org current` , `unity auth token` , `unity license` , `unity doctor --ci` , `unity docs --url` , `unity assets export` and the `unity command` dialog answer; `--no-header` leaves it out. A piped `$(unity auth token)` , `unity editors path` or `unity docs --url` now captures a table, so scripts pass `--format human` for the bare value.

  8. Change

    Under `--format tsv` (the default when piped), the notes `unity editors module add` prints, such as "All modules are already installed.", now go to stderr as warnings, so stdout holds only the table. `--quiet` hides them.

  9. Change

    `unity editors path --format ndjson` now prints the same data as `--json` as one result line, not the bare path.

  10. Change

    Under `--format tsv` (the default when piped), `unity editors prune` with missing editors now prints its `--json` fields as `key` and `value` rows ( `editors.0.version` , `missing.0.path` and so on), instead of two tables with two header rows.

  11. Change

    `--format tsv` (the default when output is piped) now starts with a header row for `unity projects` ( `add` , `remove` , `pin` , `unpin` , `import` , `create` , `link` , `unlink` , `clone` ), `unity templates` ( `location` , `edit` , `delete` , `create` , `pack` ) and `unity ci init` ; `--no-header` leaves it out. To capture a bare value in a script, read it from `--json` .

  12. Change

    `--format tsv` (the default when output is piped) now starts with a header row for `unity setup` (every client and `setup all` ), `unity skill install --all` and `unity self-install --print-target` . `setup` and `self-install --print-target` print `key` and `value` rows, one per field; `skill install --all` prints one row per skill record under the `--json` keys.

  13. Change

    `unity projects report --format tsv` now prints the same fields as `--json` : a header row of `version` , `architecture` , `installed` , `lts` , `channel` , `projects.name` and `projects.path` , then one row per project with raw values instead of translated labels.

  14. Change

    `unity mcp --exclude-tools` now hides the `unity-cli-status` tool when an entry matches it, as `--exclude-tools "*status*"` does, and refuses a call to it. `--tools` still keeps it, so a session with no Editor still says why.

  15. Change

    Breaking: `unity completion ` with `--json` , `--format json` or `--format ndjson` writes the standard JSON envelope, with the shell name in `data.shell` and the script in `data.script` , instead of the raw script. To save a script, run `unity completion ` without a machine format.

  16. Change

    `unity collab read --timestamp` accepts only an RFC 3339 / ISO 8601 date-time such as `2026-01-02T03:04:05Z` or `2026-01-02T03:04:05+02:00` , or a date such as `2026-01-02` . Any other form, such as `Fri, 02 Jan 2026 03:04:05 GMT` or `Jan 2, 2026` , is refused with exit code 2 before any request is made, instead of being converted to its UTC time.

  17. Change

    When several installed editors share a version, the `Multiple Editors` error and the `unity projects create` editor question list them in the order they were found.

  18. Change

    `unity ci init` no longer refuses a project whose root is spelled with a trailing slash when a symlink sits above that root.

  19. Change

    A folder whose `ProjectSettings/ProjectVersion.txt` is a link to nothing, a pipe or a device is no longer treated as a Unity project. Only a regular file, or a link to one, counts.

  20. Change

    `unity commands --grep` patterns use Rust regular expression syntax, so lookahead, lookbehind and backreferences are refused with a usage error, and a literal brace needs escaping ( `\{json\}` ). With `--shard` and `--rerun-failed` , a `--filter` entry that is not a valid Rust expression is refused with the reason instead of matching no tests.

  21. Change

    `unity test` , `unity test --affected` and `unity build` now sort names by code point. Only names that mix an emoji with a full-width or other character at U+E000 or above can notice.

  22. Change

    `unity shell --protocol ndjson` request lines are parsed with plain JSON rules: a repeated key keeps its last value instead of failing the request, and a lone `\ud800` -style escape is a bad request.

  23. Change

    Numeric options such as `--port` , `--pid` , `--lines` , `--tail` and `--limit` take plain whole numbers. Values like `7rows` , `1e3` and `0x50` are now usage errors instead of being read as a number.

  24. Change

    Git remote URLs with an internationalized host name now show the host in its ASCII (punycode) form, and percent escapes in a remote URL are kept as written.

  25. Change

    When several changesets share a number, `unity vcs` lists them in the order the server returned them.

Fixed

  1. Fix

    `unity cache key` now reports a path the file system rejects as a name (for example one with `|` on Windows, or an over-long name) as "not a Unity project" instead of a raw OS error.

    • Windows
  2. Fix

    `unity pipeline install` and `unity pipeline upgrade` no longer fail when the shell's working directory was deleted; they skip it and find the running Editor as before.

  3. Fix

    `unity close` and the `unity projects` commands that take one project ( `info` , `size` , `clean` , `require` , `upgrade` ) work again by absolute path when the shell's working directory was deleted, instead of failing with "No such file or directory".

  4. Fix

    `unity builds log` and `unity jobs logs` now print a `line` header row under `--format tsv` , then one row per log line, as every other command does. `unity jobs logs` no longer prints its per-step banner lines under tsv, so every row is a log line.

  5. Fix

    `--no-header` now leaves the header row out of `unity logs --console` (with or without `--follow` ) and `unity --version --format tsv` , as it does for every other command's tsv output.

  6. Fix

    `unity install modules` installs modules for a Unity version that is promoted but not yet published, on Windows. The module list now comes from the release data for that version instead of being refused as unverifiable.

    • Windows

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.