agents-fleet

Appearance

Installation ​

This page covers prerequisites, the supported install methods, provider authentication, verifying your install, and updating.

Prerequisites ​

  • Node.js ≥ 22.13.0. agents-fleet uses the node:sqlite built-in, which stabilized in Node 22.13. Check with node --version.
  • A supported LLM provider (at least one):
    • GitHub Copilot (default) — the gh CLI installed and authenticated with an active Copilot subscription.
    • Anthropic Claude — an Anthropic API key or OAuth token.
  • git — required for worktree-isolated coder workers and most workflows.

TIP

The one-line installers below will check for Node and the gh CLI and offer to install them if they're missing.

Install methods ​

macOS / Linux:

bash
curl -fsSL https://raw.githubusercontent.com/vriveras/agents-fleet/master/install.sh | bash

Windows (PowerShell):

powershell
irm https://raw.githubusercontent.com/vriveras/agents-fleet/master/install.ps1 | iex

Piped like this, the installer silently installs the latest stable release.

Pick a specific version ​

When you run the installer directly in a terminal (not piped), it shows an interactive menu of the ten most recent stable releases. Press Enter to take the latest, or type a number for an older one.

macOS / Linux:

bash
# Interactive menu (opens when run in a terminal)
bash <(curl -fsSL https://raw.githubusercontent.com/vriveras/agents-fleet/master/install.sh)

# Install a specific version directly
curl -fsSL https://raw.githubusercontent.com/vriveras/agents-fleet/master/install.sh -o install.sh
bash install.sh --version v0.36.3

# List available releases and exit (no install)
bash install.sh --list-versions

# Always install latest, skip the menu
bash install.sh --latest

Windows (PowerShell):

powershell
# Save and run directly for the interactive menu
$script = irm https://raw.githubusercontent.com/vriveras/agents-fleet/master/install.ps1
$script | Out-File install.ps1; .\install.ps1

# Install a specific version
.\install.ps1 -Version v0.36.3

# List available releases and exit
.\install.ps1 -ListVersions

# Always install latest, skip the menu
.\install.ps1 -Latest

Installer flags

install.sh also accepts --skip-node, --skip-gh, and --skip-fleet to skip individual setup steps. Run bash install.sh --help for the full list.

From source ​

bash
git clone https://github.com/vriveras/agents-fleet.git
cd agents-fleet
npm install
npm run build
npm link

This builds the TypeScript to dist/ and links the agents-fleet binary onto your PATH.

Provider authentication ​

agents-fleet needs credentials for whichever provider you launch with. Run /doctor inside the REPL at any time to verify the active provider's auth is detected.

GitHub Copilot (default) ​

  1. Install the GitHub CLI.
  2. Authenticate: gh auth login.
  3. Ensure your account has an active GitHub Copilot subscription.

Launch with the default provider:

bash
agents-fleet            # provider defaults to copilot
agents-fleet --provider copilot

Anthropic Claude ​

Set one of the following environment variables before launching:

  • ANTHROPIC_API_KEY
  • CLAUDE_CODE_OAUTH_TOKEN
  • ANTHROPIC_AUTH_TOKEN

(If you have the Claude Code CLI, claude auth login also works.)

bash
export ANTHROPIC_API_KEY=sk-ant-...
agents-fleet --provider claude

Provider pinning

A session is pinned to the provider it was created with. Resuming a Claude session under --provider copilot (or vice-versa) is rejected with a clear error. Some Claude behaviors differ slightly — for example, goal-driven loops (/loop) require --unattended under --provider claude.

Verify the install ​

bash
agents-fleet --version    # prints the installed version, e.g. 0.36.3
agents-fleet --help       # lists all CLI flags

Then launch the REPL in a project directory and run /doctor:

bash
cd your-project
agents-fleet
❯ /doctor

/doctor reports your Node version, provider auth status, gh availability, and other environment checks.

Updating ​

Re-run the one-line installer to upgrade to the latest release:

bash
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/vriveras/agents-fleet/master/install.sh | bash

# Windows
irm https://raw.githubusercontent.com/vriveras/agents-fleet/master/install.ps1 | iex

If you installed from source, pull and rebuild:

bash
git pull
npm install
npm run build

Next steps ​

  • Quickstart — launch a fleet and get your first result.
  • Core Concepts — understand what's happening under the hood.