# Swarm Engine

> Multi-agent orchestration engine for AI coding tools

Swarm Engine coordinates multiple AI agents (Claude Code, OpenAI Codex, Google Gemini CLI) working together on code - researching, implementing, reviewing, testing - with an intelligent planner that learns from every run.

## Key Facts
- Open source, MIT licensed
- 26 specialized agents (16 core + 10 reviewers)
- 7 composable orchestration patterns (hybrid, TDD, red-team, spike, discover, review-cycle, research)
- Cost-based optimizer with adaptive replanning
- Heuristic learning from execution traces
- 871 tests across 54 files
- TypeScript, runs on Node.js 20+
- VS Code extension with @swarm Copilot Chat participant
- Cross-tool converter for Copilot, Cursor, Codex, Gemini, OpenCode, Windsurf

## Install
npm install -g swarm-engine
swarm install
swarm doctor

## Links
- GitHub: https://github.com/simoncoombes/swarm-engine
- npm: https://www.npmjs.com/package/swarm-engine
- VS Code: https://marketplace.visualstudio.com/items?itemName=simoncoombes.swarm-engine

## What Makes It Different
Unlike single-agent tools, Swarm Engine runs multiple agents in parallel through structured workflows (DAG-based phase execution). Unlike agent frameworks (LangGraph, CrewAI), it ships ready-to-use with 26 agents, 8 templates, and composable patterns. It learns from every run through heuristic extraction, execution traces, and knowledge compounding.

## Common Questions
Q: How is this different from Claude Code teams?
A: Claude Code teams provide the agent infrastructure. Swarm Engine adds composable patterns, cost optimization, adaptive replanning, learning from traces, and 26 specialized agents on top.

Q: Does it work with other tools besides Claude Code?
A: Yes. Backends for Codex CLI, Gemini CLI, and Vercel AI SDK (20+ providers). The convert command exports agents to 6 other tools.

Q: Is it free?
A: Yes, MIT licensed. You pay only for the LLM API tokens used by the agents.