Skip to content

Installation ​

Chief is distributed as a single binary with no runtime dependencies. Choose your preferred installation method below.

Prerequisites ​

Chief needs an agent CLI: Claude Code (default), Codex, or OpenCode. Install at least one and authenticate.

Option A: Claude Code CLI (default) ​

bash
# Install Claude Code globally
npm install -g @anthropic-ai/claude-code

# Authenticate (opens browser)
claude login
bash
# Run directly without installing
npx @anthropic-ai/claude-code login

Option B: Codex CLI ​

To use OpenAI Codex CLI instead of Claude:

  1. Install Codex per the official reference.
  2. Ensure codex is on your PATH, or set agent.cliPath in .chief/config.yaml (see Configuration).
  3. Run Chief with chief --agent codex or set CHIEF_AGENT=codex, or set agent.provider: codex in .chief/config.yaml.

Option C: OpenCode CLI ​

To use OpenCode CLI as an alternative:

  1. Install OpenCode per the official docs.
  2. Ensure opencode is on your PATH, or set agent.cliPath in .chief/config.yaml (see Configuration).
  3. Run Chief with chief --agent opencode or set CHIEF_AGENT=opencode, or set agent.provider: opencode in .chief/config.yaml.

Option D: Cursor CLI ​

To use Cursor CLI as the agent:

  1. Install Cursor CLI per the official docs
  2. Ensure agent is on your PATH, or set agent.cliPath in .chief/config.yaml.
  3. Run agent login for authentication.
  4. Run Chief with chief --agent cursor or set CHIEF_AGENT=cursor, or set agent.provider: cursor in .chief/config.yaml.

Optional: GitHub CLI (gh) ​

If you want Chief to automatically create pull requests when a PRD completes, install the GitHub CLI:

bash
# macOS
brew install gh

# Linux
# See https://github.com/cli/cli/blob/trunk/docs/install_linux.md

# Authenticate
gh auth login

The gh CLI is only required for automatic PR creation. All other features work without it.

The easiest way to install Chief on macOS or Linux:

bash
brew install minicodemonkey/chief/chief

This method:

  • Automatically handles updates via brew upgrade
  • Installs to /opt/homebrew/bin/chief (Apple Silicon) or /usr/local/bin/chief (Intel/Linux)
  • Works on macOS (Apple Silicon and Intel) and Linux (x64 and ARM64)

Updating ​

The easiest way to update is Chief's built-in update command, which works regardless of how you installed:

bash
chief update

If you installed via Homebrew, you can also use:

bash
brew update && brew upgrade chief

Chief automatically checks for updates on startup and notifies you when a new version is available.

Install Script ​

Download and install with a single command:

bash
curl -fsSL https://raw.githubusercontent.com/minicodemonkey/chief/main/install.sh | bash

The script automatically detects your platform and downloads the appropriate binary.

Script Options ​

OptionDescriptionExample
--versionInstall a specific version--version v0.1.0
--dirInstall to a custom directory--dir /opt/chief
--helpShow all available options--help

Examples:

bash
# Install a specific version
curl -fsSL https://raw.githubusercontent.com/minicodemonkey/chief/main/install.sh | bash -s -- --version v0.1.0

# Install to a custom directory
curl -fsSL https://raw.githubusercontent.com/minicodemonkey/chief/main/install.sh | bash -s -- --dir ~/.local/bin

# Both options combined
curl -fsSL https://raw.githubusercontent.com/minicodemonkey/chief/main/install.sh | bash -s -- --version v0.1.0 --dir /opt/chief

Custom Directory

If you install to a custom directory, make sure it's in your PATH:

bash
export PATH="$HOME/.local/bin:$PATH"

Add this to your shell profile (.bashrc, .zshrc, etc.) to persist it.

Manual Binary Download ​

Download the binary for your platform from the GitHub Releases page.

Platform Matrix ​

PlatformArchitectureBinary NameNotes
macOSApple Silicon (M1/M2/M3)chief-darwin-arm64Recommended for modern Macs
macOSIntel (x64)chief-darwin-amd64For older Intel-based Macs
Linuxx64 (AMD64)chief-linux-amd64Most common Linux servers
LinuxARM64chief-linux-arm64Raspberry Pi 4, AWS Graviton

Installation Steps ​

bash
# Download the binary
curl -LO https://github.com/minicodemonkey/chief/releases/latest/download/chief-darwin-arm64

# Make it executable
chmod +x chief-darwin-arm64

# Move to a directory in your PATH
sudo mv chief-darwin-arm64 /usr/local/bin/chief
bash
# Download the binary
curl -LO https://github.com/minicodemonkey/chief/releases/latest/download/chief-darwin-amd64

# Make it executable
chmod +x chief-darwin-amd64

# Move to a directory in your PATH
sudo mv chief-darwin-amd64 /usr/local/bin/chief
bash
# Download the binary
curl -LO https://github.com/minicodemonkey/chief/releases/latest/download/chief-linux-amd64

# Make it executable
chmod +x chief-linux-amd64

# Move to a directory in your PATH
sudo mv chief-linux-amd64 /usr/local/bin/chief
bash
# Download the binary
curl -LO https://github.com/minicodemonkey/chief/releases/latest/download/chief-linux-arm64

# Make it executable
chmod +x chief-linux-arm64

# Move to a directory in your PATH
sudo mv chief-linux-arm64 /usr/local/bin/chief

Detect Your Architecture

Not sure which binary you need? Run these commands:

bash
# macOS
uname -m  # arm64 = Apple Silicon, x86_64 = Intel

# Linux
uname -m  # x86_64 = AMD64, aarch64 = ARM64

Building from Source ​

Build Chief from source if you want the latest development version or need to customize the build.

Prerequisites ​

  • Go 1.21 or later (install Go)
  • Git for cloning the repository

Build Steps ​

bash
# Clone the repository
git clone https://github.com/minicodemonkey/chief.git
cd chief

# Build the binary
go build -o chief ./cmd/chief

# Optionally install to your GOPATH/bin
go install ./cmd/chief

Build with Version Info ​

For a release-quality build with version information embedded:

bash
go build -ldflags "-X main.version=$(git describe --tags --always)" -o chief ./cmd/chief

Verify the Build ​

bash
./chief --version

Verifying Installation ​

After installing via any method, verify Chief is working correctly:

bash
# Check the version
chief --version

# View help
chief --help

# Check that your agent CLI is accessible (Claude default, or codex if configured)
claude --version
# or: codex --version

Expected output (example with Claude):

$ chief --version
chief version vX.Y.Z

$ claude --version
Claude Code vX.Y.Z

Troubleshooting

If chief is not found after installation:

  1. Check that the installation directory is in your PATH
  2. Open a new terminal window/tab to reload your shell
  3. Run which chief to see if it's found and where

See the Troubleshooting Guide for more help.

Next Steps ​

Now that Chief is installed:

  1. Quick Start Guide - Get running with your first PRD
  2. How Chief Works - Understand the autonomous agent concept
  3. CLI Reference - Explore all available commands