Unity CLI 1.0.1
33 documented changes.
- Version
- 1.0.1
- Released
- Nov 16, 2026
- Product
- Unity CLI
Unity CLI 1.0.1
Security
- 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
- 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
- Change
`unity logs --format ndjson` now ends with the same paging fields as other listings ( `total` , `nextPage` , `partial` ) in its final result line.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Change
`unity editors path --format ndjson` now prints the same data as `--json` as one result line, not the bare path.
- 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.
- 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` .
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Change
`unity ci init` no longer refuses a project whose root is spelled with a trailing slash when a symlink sits above that root.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Change
When several changesets share a number, `unity vcs` lists them in the order the server returned them.
Fixed
- 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
- 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.
- 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".
- 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.
- 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.
- 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