The Unity CLI: manage Unity from your terminal

What is the Unity CLI

The CLI ships as a single self-contained binary. There are no dependencies to install, and installation adds itself to your PATH: simply run it as unity, and update it in place with unity upgrade. Beyond editors and projects, it also handles modules and authentication, so a fresh machine needs nothing else.

Because it's a native binary, it starts quickly, whereas the old Unity Hub headless path (-- --headless) took noticeably longer. This gap adds up across the dozens of calls a script or agent makes per job.

Get started

Install it with your platform’s package manager:

# macOS or Linux curl -fsSL https: //public-cdn.cloud.unity3d.com/hub/prod/cli/install.sh | UNITY_CLI_CHANNEL=beta bash # Windows $env:UNITY_CLI_CHANNEL= 'beta' ; irm https: //public-cdn.cloud.unity3d.com/hub/prod/cli/install.ps1 | iex

(Note: Support for standard package managers like brew, winget and apt is coming soon. Refer to the CLI documentation for the latest.)

Explore what's available:

unity --help

Installing an editor with the modules you need is a one-liner:

... continue reading