Company agents with shared context and skills

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

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, fx, 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 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:

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.

Plan for at least 4 vCPU, 8 GB RAM and 40 GB of free disk, and prune old Docker images after upgrades. See Host requirements & disk cleanup.

This is the beginning of the README. Read the rest at the original. Read the full README ↗