jayminwest/overstory
1,202 stars · Last commit 2026-03-28
Multi-agent orchestration for AI coding agents — pluggable runtime adapters for Claude Code, Pi, and more
README preview
# Overstory Multi-agent orchestration for AI coding agents. [](https://www.npmjs.com/package/@os-eco/overstory-cli) [](https://github.com/jayminwest/overstory/actions/workflows/ci.yml) [](LICENSE) Overstory turns a single coding session into a multi-agent team by spawning worker agents in git worktrees via tmux, coordinating them through a custom SQLite mail system, and merging their work back with tiered conflict resolution. A pluggable `AgentRuntime` interface lets you swap between 11 runtimes — Claude Code, [Pi](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Aider](https://aider.chat), [Goose](https://github.com/block/goose), [Amp](https://amp.dev), or your own adapter. > **Warning: Agent swarms are not a universal solution.** Do not deploy Overstory without understanding the risks of multi-agent orchestration — compounding error rates, cost amplification, debugging complexity, and merge conflicts are the normal case, not edge cases. Read [STEELMAN.md](STEELMAN.md) for a full risk analysis and the [Agentic Engineering Book](https://github.com/jayminwest/agentic-engineering-book) ([web version](https://jayminwest.com/agentic-engineering-book)) before using this tool in production. ## Install Requires [Bun](https://bun.sh) v1.0+, git, and tmux. At least one supported agent runtime must be installed: - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (`claude` CLI) - [Pi](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent) (`pi` CLI) - [GitHub Copilot](https://github.com/features/copilot) (`copilot` CLI) - [Codex](https://github.com/openai/codex) (`codex` CLI)