← all repositories
desplega-ai/agent-swarm

An OS for companies where AI agents remember last week’s failures

Agent Swarm orchestrates lead and worker agents in Docker to handle cross-tool tasks, then feeds their learnings into a shared memory so the fleet theoretically improves over time.

761 stars TypeScript AgentsLLMOps · Eval
agent-swarm
Velocity · 7d
+2.9
★ / day
Trend
steady
star history

What it does

Agent Swarm is a TypeScript orchestration platform that ingests tasks from Slack, GitHub, GitLab, Linear, Jira, email, or an API. A lead agent breaks down requests and delegates them to worker agents running inside isolated Docker environments. The workers execute the work—shipping pull requests, drafting reports, or answering threads—and write their output and learnings into a persistent memory store so the swarm is meant to accumulate context across sessions.

The interesting bit

The project frames itself as a “Compounding Intelligence Layer,” giving each agent a persistent identity and memory via vector search and per-agent files like SOUL and CLAUDE.md. It also tries to stay harness-agnostic, supporting Claude Code, OpenAI Codex, raw LLMs, and others while preserving task continuity across restarts and provider swaps. That is a harder engineering problem than the usual single-model chat wrapper.

Key highlights

  • Lead/worker orchestration inside Docker with priority queues, isolated environments, and pause/resume across deploys.
  • Persistent memory and identity system using vector search and agent-specific files, meant to let expertise compound horizontally across the swarm.
  • Human-in-the-loop approval gates for irreversible steps, plus workflow patterns like “Litmus Tests” (LLM-as-judge) and “Drain Loops” (chained reviewable PRs).
  • Multi-channel task ingestion from Slack, GitHub, email, WhatsApp, Linear, Jira, and more.
  • LLM-agnostic harness support with a bounded context preamble that carries task chain history across different providers and restarts.

Caveats

  • The README is heavy on vision and light on implementation specifics; most architectural detail lives behind external documentation links.
  • The project is backed by Desplega Labs and includes a hosted dashboard and commercial support offers, so self-hosters should expect some vendor ecosystem entanglement.
  • A maintainer note warns that the repo “evolves every single day,” which suggests APIs and features are currently in flux.

Verdict

A solid candidate if you are looking to automate complex, cross-tool company workflows and can tolerate early-stage churn. Skip it if you just need a simple LLM wrapper or a one-off cron script.

Frequently asked

What is desplega-ai/agent-swarm?
Agent Swarm orchestrates lead and worker agents in Docker to handle cross-tool tasks, then feeds their learnings into a shared memory so the fleet theoretically improves over time.
Is agent-swarm open source?
Yes — desplega-ai/agent-swarm is open source, released under the MIT license.
What language is agent-swarm written in?
desplega-ai/agent-swarm is primarily written in TypeScript.
How popular is agent-swarm?
desplega-ai/agent-swarm has 761 stars on GitHub and is currently holding steady.
Where can I find agent-swarm?
desplega-ai/agent-swarm is on GitHub at https://github.com/desplega-ai/agent-swarm.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.