Installation

This guide covers the supported install paths. Most users want the npm install. Pre-built binaries and a from-source build are documented below for niche cases.

Prerequisites

  • An account for the provider(s) you'll use: GitHub, GitLab, Jira, ClickUp, Slack, or Fireflies (any subset).
  • For the build-from-source path only: Rust 1.75 or later and Git.

Installation methods

Single command — the correct binary for your platform is fetched automatically. Global install puts devboy on your PATH.

npm
pnpm
yarn
npm install -g @devboy-tools/cli

After install, the fastest first run:

devboy onboard      # auto-detects your AI agent + installs the right skill bundle
devboy doctor       # verifies provider config and credentials

See Quick start for the full first-run flow.

From source (for contributors)

Build the binary yourself. Requires Rust 1.75+ and Git.

git clone https://github.com/meteora-pro/devboy-tools.git
cd devboy-tools
cargo build --release
# Binary lands at ./target/release/devboy — copy to a PATH dir
sudo cp ./target/release/devboy /usr/local/bin/devboy

From pre-built binaries

Download pre-built binaries from the Releases page.

macOS:

# Download the latest release for your architecture
curl -L -o devboy.tar.gz https://github.com/meteora-pro/devboy-tools/releases/latest/download/devboy-macos-arm64.tar.gz

# Extract
tar -xzf devboy.tar.gz

# Move to a directory in your PATH
sudo mv devboy /usr/local/bin/

Linux:

# Download for x86_64
curl -L -o devboy.tar.gz https://github.com/meteora-pro/devboy-tools/releases/latest/download/devboy-linux-x86_64.tar.gz

# Extract
tar -xzf devboy.tar.gz

# Move to a directory in your PATH
sudo mv devboy /usr/local/bin/

Windows:

  1. Download devboy-windows-x86_64.exe.zip from releases
  2. Extract the ZIP file
  3. Add the directory to your PATH environment variable

Verify installation

After installation, verify that DevBoy is working:

devboy --help

You should see the help output with available commands.

Next steps

Now that you have DevBoy installed, proceed to the Quick Start guide to configure your first integration.