Documentation

Unity command-line interface (CLI)

Download Unity Hub

Unity command-line interface (CLI)

Unity CLI release notes for April 2026

Learn about the Unity CLI releases in April 2026.
Read time 2 minutesLast updated a day ago

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

0.1.0-beta.3

Release date: April 24, 2026
  • Fixed an issue where
    unity install
    ,
    unity install-modules
    , and
    unity auth
    failed with a service resolution error after a fresh installation.
  • Fixed an issue on Linux where the CLI used
    ~/.local/share/unityhub
    for Hub data. The CLI now reads and writes Hub data in
    ~/.config/unityhub
    , which matches the Unity Hub location and keeps projects, Editors, and preferences synchronized between the CLI and Unity Hub.

0.1.0-beta.2

Release date: April 23, 2026
  • Added
    unity implode
    to uninstall the CLI. This command removes the installed binary and environment files and clears stored credentials from the operating system keyring. In non-interactive shells, the command requires the
    --yes
    flag and only works on a CLI installed using the official installer.
  • Added
    unity projects create
    to create a Unity project from the CLI.
  • Added
    unity changelog
    to display the release notes for the installed CLI.
  • Added
    unity upgrade --changelog
    to preview release notes for an update without installing it.
  • Added
    unity upgrade --target <version>
    to upgrade to a specific published version instead of the latest version in your channel.
  • Added interactive
    unity upgrade
    which shows release note previews for the target version before confirmation.

0.1.0-beta.1

Release date: April 04, 2026
First public beta release of Unity CLI. This release provides a single executable for macOS, Linux, and Windows on x64 and Arm64 architectures. Install Unity CLI by using
install.sh
or
install.ps1
.
  • Authentication: Added
    unity auth
    with secure token storage in the operating system keychain:
    • Keychain on macOS
    • Credential Manager on Windows
    • libsecret on Linux
  • Editor management: Added the following commands:
    • unity editors
      ,
      unity install
      ,
      unity uninstall
      ,
      unity install-modules
      , and
      unity install-path
    • Supports Editor version aliases
    • Installs Editor versions with or without a changeset
  • Project management: Added the following commands:
    • unity projects
      to list, add, remove, and create projects
    • unity open <path>
      to open a project
    • Supports bare-path syntax, such as
      unity ./MyProject
  • Upgrade management: Added
    unity upgrade
    . Automatically selects the appropriate update channel based on the installed version (stable or prerelease).
  • Localization: Added the
    unity language
    command.
    • Added support for 13 locales
  • Output formats: Added the global
    --format <human|json|tsv>
    flag for machine-readable output. Suppresses the interactive banner for JSON and TSV output and when output is piped.
  • Verifiable downloads: Added SHA-256 checksums for all platform binaries