Apra Fleet

Coordinate AI coding agents across every machine in your network — from a single conversation.

Apra Fleet is an open-source MCP server for LLM orchestration and agentic workflow automation. It enables multi-agent systems where autonomous agents coordinate across machines via SSH. Built for developers using Claude Code, Cursor, Copilot, Windsurf, and other AI coding assistants. Supports agent memory persistence, remote execution, and cloud compute.

Why

You're working with an AI coding agent and you want to:

Run your test suite on Linux while you develop on macOS
Have one agent build the frontend, another the backend, and a third running tests — all in parallel
Spin up isolated workspaces on the same machine without them stepping on each other
Use a beefy cloud VM for compilation while coding from your laptop
Coordinate autonomous agents across your entire infrastructure — one conversation, zero context-switching

Apra Fleet makes all of this a conversation. No dashboards, no orchestration YAML — just tell your agent what you want and it happens.

Apra Fleet is the missing orchestration layer between your AI coding assistant and your infrastructure.

How it works

Apra Fleet is an MCP server that agentic coding systems connect to. It manages a registry of members (machines with an AI coding agent installed) and provides tools to register them, send files, execute prompts, and check status. Remote members connect via SSH. Local members run as isolated child processes on the same machine.

Quick start

See the User Guide for step-by-step install and usage instructions.

TL;DR:

# Download the binary for your platform from GitHub Releases
# https://github.com/Apra-Labs/apra-fleet/releases

# Install (registers MCP server, hooks, statusline, and optionally the PM skill)
./apra-fleet install --skill

# Load in Claude Code
/mcp

Then just talk to Claude:

"Register 192.168.1.10 as build-server. Username is akhil, use password auth, work folder /home/akhil/projects/myapp."

Tools

Tool	Description
`register_member`	Register a machine as a fleet member (local or remote via SSH)
`remove_member`	Unregister a fleet member
`update_member`	Update a member's registration (rename, change host, folder, auth, git access)
`list_members`	List all registered fleet members
`member_detail`	Deep-dive status for a single member
`fleet_status`	Overview status of all members
`execute_prompt`	Run a Claude prompt on a member (supports session resume)
`execute_command`	Run a shell command directly on a member (no Claude CLI needed)
`reset_session`	Clear session ID so the next prompt starts fresh
`send_files`	Upload local files to a remote member via SFTP
`provision_auth`	Deploy OAuth credentials or an API key to a member
`setup_ssh_key`	Generate SSH key pair and migrate from password to key auth
`setup_git_app`	One-time setup: register a GitHub App for scoped git token minting
`provision_vcs_auth`	Deploy VCS credentials to a member (GitHub App, Bitbucket, Azure DevOps)
`revoke_vcs_auth`	Remove deployed VCS credentials from a member
`cloud_control`	Start, stop, or check status of cloud compute instances
`monitor_task`	Monitor long-running tasks on cloud members
`update_llm_cli`	Update or install AI coding agent CLI on members
`shutdown_server`	Gracefully shut down the MCP server

PM Skill

Apra Fleet ships with an optional Project Manager skill that orchestrates multi-step work across members — planning, doer-reviewer loops, verification checkpoints, and deployment. Install it with --skill during setup. See skills/pm/SKILL.md for details.

Git Authentication

Fleet can provision scoped, short-lived tokens to members — so each member gets only the git access it needs.

Supported providers: GitHub (App or PAT), Bitbucket (API token), Azure DevOps (PAT).

Access levels: read, push, admin, issues, full.

See docs/design-git-auth.md for the full design.

Secure Password Entry

When registering a remote member with password authentication, you don't need to pass the password inline. Apra Fleet opens a separate terminal window for password entry so credentials never appear in chat history or logs.

Password is encrypted immediately with AES-256-GCM and never stored in plaintext
Works on macOS (Terminal.app), Windows (cmd), and Linux (gnome-terminal/xterm)
Headless or unsupported environments get a manual command fallback
Supports password rotation via update_member

See docs/adr-oob-password.md for the design rationale.

Cloud Compute

Fleet members can run on cloud instances (AWS EC2) that start and stop automatically based on demand. When you send a prompt to a cloud member, Apra Fleet starts the instance, waits for SSH, re-provisions credentials, and executes the work. When the member goes idle, it stops the instance to save costs.

Auto start/stop — instances start on demand and stop after a configurable idle timeout
GPU-aware idle detection — monitors GPU utilization via nvidia-smi so GPU workloads keep instances alive
Long-running tasks — a task wrapper script survives SSH disconnects, supports retry with restart commands, and tracks status
Cost tracking — real-time cost estimates based on instance type and uptime, with warnings for high spend
Custom workload detection — define a shell command to signal busy/idle for arbitrary workloads (CPU training, downloads, etc.)

See docs/cloud-compute.md for setup and configuration details.

Development

npm install && npm run build   # Build from source
npm test                       # Unit tests (vitest)
npm run build:binary           # Build single-executable binary
node dist/index.js install     # Dev-mode install (registers MCP, hooks, statusline)

Roadmap

See ROADMAP.md for planned features and good-first-issue ideas for contributors.

License

Apache 2.0 — see LICENSE for the full text.