Installation

Install and update the Terra CLI, then set up shell completion.

Choose an installation method:

Native Install (Recommended)

Copy and run the command for your platform in your terminal.

macOS and Linux:

curl -fsSL https://cli.tryterra.co/install.sh | sh

Windows PowerShell:

irm "https://cli.tryterra.co/install.ps1" | iex

See Updates for automatic updates and upgrading older versions.

npm

macOS, Linux, and Windows:

Requires Node.js 18 or later.

npm install -g @tryterra/cli

To upgrade with npm:

npm install -g @tryterra/cli@latest

Or run it without installing:

npx @tryterra/cli version

Do not install with --no-optional or --omit=optional. The wrapper package depends on one optional platform package that carries the binary. Skipping it leaves nothing to run.

Homebrew

macOS:

brew install tryterra/tap/terra

Shell completion for bash, zsh, and fish is installed with it.

To upgrade with Homebrew:

brew upgrade tryterra/tap/terra

Coding agent

If you use Claude Code, Codex or Cursor, install the Terra API plugin. When the CLI is missing or logged out, the agent offers to install it and log you in. In Claude Code:

/plugin marketplace add tryterra/agent-skills
/plugin install terra@terra

See Agent skills for Codex and Cursor.

Check the installation:

terra version

Next, log in to Terra.

Updates

Standalone, global npm, and Homebrew installations update automatically. Eligible commands can start a background check once every four hours. Your command does not wait for the check or installation; subsequent invocations use the updated version. The next invocation reports the update outcome.

To update explicitly:

terra update
terra version

terra update uses the original installation method. On Windows, it schedules installation after the command exits. Updates never request elevated permissions. Standalone updates verify signed checksums before replacing the binary.

Coding agents can trigger automatic updates. CI, help, version, and completion commands do not. Project dependencies, npx, and pinned Homebrew installations are not changed automatically. Other installation methods receive manual update instructions.

To control automatic updates:

Variable	Behavior
TERRA_NO_AUTO_UPDATE=1	Keep update notices without installing updates
TERRA_NO_UPDATE_NOTIFIER=1	Disable automatic update checks and installs
DO_NOT_TRACK=1	Disable automatic update activity and usage reporting

These settings do not prevent an explicit terra update.

Upgrade from an older version

terra update is available from v0.15.0. To upgrade an older standalone installation, rerun the installer:

curl -fsSL https://cli.tryterra.co/install.sh | sh

For an older npm or Homebrew installation, use the upgrade command in its installation tab above.

Shell completion

A Homebrew install sets up completion for bash, zsh, and fish. For a native or npm install, generate the script and put it where your shell reads completions.

zsh

mkdir -p ~/.terra
terra completion zsh > ~/.terra/_terra

Then in ~/.zshrc, before compinit:

fpath=(~/.terra $fpath)
autoload -Uz compinit && compinit

bash

# macOS, with Homebrew bash-completion
terra completion bash > /usr/local/etc/bash_completion.d/terra

# Linux
terra completion bash > /etc/bash_completion.d/terra

fish

terra completion fish > ~/.config/fish/completions/terra.fish

PowerShell

terra completion powershell | Out-String | Invoke-Expression

Add this line to your PowerShell profile to make it permanent.

Releases

Every release, with archives, checksums, and signatures, is on GitHub. The changelog lists what changed in each version.