A fleet of prebuilt AI teammates for recurring engineering work.

agentsfleet is a fleet of prebuilt AI teammates for recurring engineering work. Each one wakes on an event — a pull request, an incident, a deploy — reads your code, telemetry, internal docs, and live control-plane state, finds the root cause, and opens a scenario-backed fix. A human approves, then it ships the fix or drafts the customer reply. Every step is a replayable log.

• Human approval, by design — the agent investigates and proposes; a person approves before anything ships
• Replayable event logs — audit every action and decision
• Bring your own provider keys — no vendor lock-in on inference
• Runs locally or against production — same agent, same evidence

Agents are defined in Markdown playbooks with tools, triggers, and investigation steps. Open-source runtime, hosted control plane — the teammate, not a wrapper around someone else's.

---

Quick start

npm install -g @agentsfleet/cli
agentsfleet login

Define an agent in Markdown, connect a webhook, and get an evidenced diagnosis and a proposed fix on your next pull request or incident. Full walkthrough at docs.agentsfleet.net/quickstart — free to try, no card, under five minutes.

---

What's in this repo

Directory	What
src/	Zig backend — agentsfleetd control plane (HTTP, leases) + agentsfleet-runner execution daemon
ui/packages/app/	Dashboard — Next.js, Clerk auth
ui/packages/website/	Marketing site — agentsfleet.net
ui/packages/design-system/	Shared UI components
cli/	Command-line interface (CLI) — install, manage agents, tail runs
public/openapi/	OpenAPI spec
schema/	Postgres migrations

---

Local development

Prerequisites: Zig 0.16.0 · Docker (Postgres + Redis) · Bun ≥1.3 · Clerk dev project · 1Password CLI for secrets

git clone https://github.com/agentsfleet/agentsfleet.git
cd agentsfleet

# Populate .env before running make up. See playbooks/founding/01_bootstrap/001_playbook.md for the full bootstrap.
make up           # Postgres + Redis + agentsfleetd (auto-migrates DB)

cd ui/packages/app
echo "NEXT_PUBLIC_API_URL=http://localhost:3000" > .env.local
bun install && bun run dev

Verify:

make lint-all
make test-unit-all
make test-integration   # needs make up running

---

CLI

agentsfleet defaults to production. Point it at your local stack with the --api flag, or persist it via the environment:

agentsfleet --api http://localhost:3000 <command>
export AGENTSFLEET_API_URL=http://localhost:3000   # or set it once

---

Contributing

Enable git hooks: git config core.hooksPath .githooks

Coding conventions and the agent operating model live in AGENTS.md.

The playbooks/ tree bootstraps your own private agentsfleet instance — a Fly.io control plane behind a Cloudflare Tunnel, with Clerk for auth and 1Password (op) for every secret. Start at playbooks/founding/01_bootstrap/001_playbook.md.

For the system design — control plane, runner fleet, data flow, scaling — see docs/architecture/, and the tunnel-first deployment rationale in playbooks/ARCHITECTURE.md.

---

Repos

Repo	What
agentsfleet/agentsfleet	Control plane + runner + CLI (this repo)
agentsfleet/docs	User docs (docs.agentsfleet.net)
agentsfleet/skills	Agent skill libraries
agentsfleet/posthog-zig	PostHog SDK for Zig

MIT — Copyright (c) 2026 agentsfleet.