Agent Swarm README

An engine to make your company AI Native
_{Built by desplega.sh.}

[!TIP] This repo evolves every single day. Watch now →

_{▸ 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
Workers in isolated Docker containers with development environments
Memory and identity that persist across sessions
Workflows, schedules, scripts, and apps for recurring work
Your choice of harness and models: Claude Code, Codex, pi, opencode, Devin, or ACP agents

mermaid

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

    LEAD(["Lead Agent<br/>plans &amp; delegates"])

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

    subgraph BRAIN["Persistent brain"]
        direction TB
        MEM["Memory<br/>(vector search)"]
        ID["Identity<br/>(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:

Terminal

npx skills add desplega-ai/agent-swarm

Or use the examples directly:

bash

git clone https://github.com/desplega-ai/agent-swarm.git && cd agent-swarm
cp .env.docker.example .env  # Set API_KEY, a harness credential, and all eight agent UUIDs.
openssl rand -base64 32 > encryption_key
chmod 600 .env encryption_key
docker compose -f docker-compose.example.yml --env-file .env up -d

Read the Compose checklist before starting. API: http://localhost:3013, with /docs and /openapi.json. Dashboard: connect it to your API. Kubernetes: install the OCI Helm chart.

Integrations

Slack · GitHub · GitLab · Linear · Jira · AgentMail · WhatsApp (Kapso) · Composio · Sentry · Devin. Integration guides.

Learn more

Getting started · Architecture · Playbooks · CLI · API reference
Agent templates
Help: contact@desplega.sh · Discord

Contributing

Read CONTRIBUTING.md, fork the repository, create a branch, and open a PR. Discuss ideas on Discord.

Are you an agent? Run npx skills add desplega-ai/agent-swarm or read the operator skill.

Star History

License

MIT · 2025-2026 desplega.sh