# Installation

import { PackageManagerTabs } from '@rspress/core/theme';

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

### From npm (recommended)

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

<PackageManagerTabs
  command={{
    npm: 'npm install -g @devboy-tools/cli',
    pnpm: 'pnpm add -g @devboy-tools/cli',
    yarn: 'yarn global add @devboy-tools/cli',
  }}
/>

After install, the fastest first run:

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

See [Quick start](./quick-start) for the full first-run flow.

### From source (for contributors)

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

```bash
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](https://github.com/meteora-pro/devboy-tools/releases) page.

**macOS:**
```bash
# 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:**
```bash
# 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:

```bash
devboy --help
```

You should see the help output with available commands.

## Next steps

Now that you have DevBoy installed, proceed to the [Quick Start](/getting-started/quick-start) guide to configure your first integration.
