Installation

Install the Rush toolchain in one command. Works on macOS and Linux.

One-line install#

The install script fetches the latest signed binary for your platform, places it in ~/.rush/bin, and adds that directory to your shell's PATH.

curl -fsSL https://cdn.getrush.ai/install.sh | bash

Restart your shell (or source ~/.zshrc), then verify:

rush --version

The installer detects zsh, bash, and fish and appends the PATH line to the matching rc file. It's idempotent — re-running won't duplicate the entry.

Binary	Role
`rush`	Runtime. Runs agents, installs them from the registry, manages sessions.
`rushx`	Quick-run helper. Runs a single agent from the registry without installing.

The same rush binary also builds and publishes agents. No separate CLI needed. To unlock the developer commands (rush init, rush build, rush publish, rush verify, rush unpublish), enable Developer Mode once:

rush dev enable

See the Developer Mode guide for what it does and how to turn it on via the web console.

From source (contributors only)#

If you're hacking on the monorepo, use the in-repo install script:

./rush/cli/scripts/install.sh

Requires Go 1.22+. Not needed for normal usage.

How the installer works#

The one-liner is a small shell script that figures out your OS and architecture, fetches the signed rush binary, and puts it on disk.

Binaries are signed with Ed25519. The installer verifies the signature before placing anything in ~/.rush/bin.

Next#

Create your account

Build your first agent

Define, test, and publish an agent in five minutes.