agent-swarm

Agent Swarm is the open-source, self-hosted AI company operating system built by Desplega Labs.

[!TIP] This repo evolves every single day. Watch now → ▸ every team, one swarm · daily evolution · slack → pr · Making of

agent-swarm.dev is an open-source operating system for AI work. A lead agent delegates goals to workers such as Claude Code or Codex. Isolated containers, shared memory, tools, schedules, and review gates preserve work across sessions.

What you get

• A lead agent that receives work from Slack, repositories, issue trackers, email, or the API
• Schema-validated task results for callers that need structured JSON output
• Deferred tasks that wake when all or any watched tasks reach an outcome, or a deadline arrives
• Inline tool-result images in task logs, with previews that open at full size
• Dashboard file attachments by paste, drag-and-drop, or file picker
• Workers in isolated Docker containers with development environments
• Memory and identity that persist across sessions, with citation ratings and self-rating hints enabled by default
• Workflows, schedules, scripts, and apps for recurring work
• Extensions for trusted TypeScript hooks, installed as agent-owned inert drafts and activated by a trusted lead, operator, or dashboard user
• Realtime rooms for shared page state, presence, and live channels
• Your choice of harness and models: Claude Code, Codex, pi, opencode, Cursor, Amp, Grok, Devin, or ACP agents

flowchart LR
    subgraph IN["Tasks come in"]
        direction TB
        S["Slack"]
        G["GitHub / GitLab"]
        E["Email"]
        A["API / CLI"]
    end

    LEAD(["Lead Agentplans & delegates"])

    subgraph WORKERS["Workers in Docker"]
        direction TB
        W1["Worker"]
        W2["Worker"]
        W3["Worker"]
    end

    subgraph BRAIN["Persistent brain"]
        direction TB
        MEM["Memory(vector search)"]
        ID["Identity(SOUL, CLAUDE.md)"]
    end

    subgraph OUT["Work ships"]
        direction TB
        PR["Pull Requests"]
        REPLY["Slack replies"]
        EMAIL["Email replies"]
    end

    IN --> LEAD --> WORKERS
    WORKERS -->|reads context| BRAIN
    WORKERS -->|writes learnings| BRAIN
    WORKERS --> OUT

Quick Start

Give your coding agent the operator skill for Docker Compose or Kubernetes:

npx skills add desplega-ai/agent-swarm

Or install it as a plugin in your harness:

Harness	Command
Claude Code	/plugin marketplace add desplega-ai/agent-swarm then /plugin install agent-swarm@agent-swarm
Codex	codex plugin marketplace add desplega-ai/agent-swarm && codex plugin add agent-swarm@agent-swarm (or use npx skills above)
Cursor	/add-plugin desplega-ai/agent-swarm
Gemini CLI	gemini extensions install https://github.com/desplega-ai/agent-swarm
Antigravity / Factory Droid	droid plugin marketplace add https://github.com/desplega-ai/agent-swarm then droid plugin install agent-swarm@agent-swarm
OpenCode, pi, Devin, Kimi, others	npx skills add desplega-ai/agent-swarm

The plugin's privacy and terms links describe the Agent Swarm website and Cloud service. The self-hosted software remains covered by the MIT License.

Or self-host. docker-compose.example.yml is the reference deployment: deploy every agent in it by default (1 lead and 11 workers on the official templates), and remove agents only when you have a reason to.

The one-shot installer checks Docker and Compose v2, installs Bun when missing, runs agent-swarm onboard --yes, and prints the dashboard /setup link. It defaults to the single-agent solo preset, so pass --preset full for every official template (it runs one coder where the example runs two):

curl -fsSL https://raw.githubusercontent.com/desplega-ai/agent-swarm/main/install.sh | bash -s -- --preset full

Or use the examples directly:

git clone https://github.com/desplega-ai/agent-swarm.git && cd agent-swarm
cp .env.docker.example .env  # Set API_KEY and the credential for your HARNESS_PROVIDER.
openssl rand -base64 32 > encryption_key
chmod 600 .env encryption_key
docker compose -f docker-compose.example.yml --env-file .env up -d

Agent ID variables are optional. Each container generates a UUID on first boot and keeps it in its personal volume, so identity survives restarts. Pin *_AGENT_ID in .env only to keep an existing identity or to survive removing volumes.

Read the Compose checklist before starting. API: http://localhost:3013, with /docs and /openapi.json. Next, open the dashboard and connect it to your API with API_KEY. A new install lands on /setup, a guided first run that covers providers, agents, memory, integrations, and a first task. Kubernetes: install the OCI Helm chart.

Integrations

Slack · GitHub · GitLab · Azure DevOps · Linear · Jira · AgentMail · WhatsApp (Kapso) · Telegram, Teams and Discord (Chat SDK) · Composio · Sentry · Devin · Serply search. [