Skip to Content
Getting StartedInstallation

Installation

Pilot is a single Go binary. Install it, run pilot doctor, and you’re ready.

The install script downloads the latest release for your platform and installs to ~/.local/bin/pilot.

curl -fsSL https://raw.githubusercontent.com/alekspetrov/pilot/main/install.sh | bash

This method supports hot-upgrade — Pilot can update itself in-place without manual intervention. When running in daemon mode (pilot start), press u in the dashboard to upgrade without downtime. See Hot Upgrade for details.

The script auto-detects your OS (macOS/Linux) and architecture (amd64/arm64). It also adds ~/.local/bin to your PATH if needed.

Alternative: Homebrew

brew tap alekspetrov/pilot
brew install pilot

Homebrew installations cannot use pilot upgrade or hot-upgrade. Homebrew manages the binary location, so self-update is blocked. Use brew upgrade pilot instead. If you want Pilot’s built-in upgrade flow, use the curl install above.

Alternative: From Source

git clone https://github.com/alekspetrov/pilot.git
cd pilot
make build
# Binary at ./bin/pilot — copy to your PATH
cp ./bin/pilot ~/.local/bin/pilot

Verify Installation

pilot --version
# pilot version v2.56.0

Run the health check to verify all dependencies:

pilot doctor

pilot doctor checks for:

  • Claude Code — CLI installed and accessible
  • Git — version control available
  • gh (optional) — GitHub CLI for PR management
  • Configuration — config file exists and is valid
  • Tokens — required environment variables are set

If pilot doctor reports issues, see Troubleshooting for common fixes.

Next Steps

PrerequisitesQuick Start