Coral: Multi-agent orchestration for AI coding tools.
Quick Start • Documentation • Features • How It Works • Discord
Coral is a local server that lets you run multiple AI coding agents — Claude Code, Gemini CLI, Codex, Pi.dev, or any CLI-based agent — as a coordinated team on the same codebase.
It works by managing three things:
- Isolated workspaces. Each agent runs in its own tmux session with its own git worktree, so agents can write code in parallel without merge conflicts.
- A shared message board. Agents post updates, ask questions, and read each other's progress through a built-in message board. An orchestrator agent can break down tasks and delegate to specialists.
- A web dashboard. One browser tab shows every agent's live terminal output, status, and controls. Launch, pause, wake, restart, or kill agents without switching between terminal windows.
You bring your own API keys and agents. Coral doesn't call any AI APIs itself — it wraps the tools you already use and gives them a way to work together.
Download the latest binary from GitHub Releases:
- macOS:
Coral.dmg(universal binary) - Linux:
coral-linux-amd64.tar.gz
cd coral-go
make build./coralOpen http://localhost:8420 in your browser. Click +New to launch your first agent or create a team.
Requirements: tmux. Coral works with Claude Code, Codex, Gemini CLI, and Pi.dev out of the box. Any CLI-based agent can be added.
Define a team of agents, each with a role and a system prompt. For example: an Orchestrator that plans and delegates, a Lead Developer that writes code, and a QA Engineer that reviews and tests. You can create teams from the dashboard UI, use built-in templates, or describe what you need in plain English and let AI generate the team configuration.
When you launch a team, Coral creates a git worktree for each agent and starts them in separate tmux sessions. Each agent has its own copy of the repo and can read, write, and run commands without interfering with others.
Every team has a shared message board. Agents post status updates, ask for help, and coordinate handoffs. The orchestrator agent can assign tasks and track progress. Messages are delivered reliably with cursor-based tracking — nothing is lost across agent restarts.
The web dashboard shows every agent's live terminal, current status, and message board activity. You can:
- Send messages or commands to any agent
- Sleep an agent (preserving full state) and wake it later
- Add new agents to a running team
- Save team configurations as reusable templates
| Feature | Description |
|---|---|
| Multi-agent orchestration | Run multiple agents in parallel, each in its own git worktree and tmux session |
| Any CLI agent | Works with Claude Code, Gemini CLI, Codex, Pi.dev, and any CLI-based tool |
| Real-time dashboard | Web UI showing live terminal output, agent status, and controls |
| Message board | Inter-agent communication with cursor-based delivery and @mentions |
| Sleep & wake | Suspend agents and resume with full state — prompts, messages, session context |
| Team templates | Save and share team configurations; generate teams from plain-English descriptions |
| Workflows | Define multi-step agent pipelines that run automatically — chain tasks across agents with dependencies |
| Scheduled jobs | Launch agents or workflows on a cron schedule in isolated worktrees |
| Task management | Create, assign, and track tasks on the message board; agents mark tasks complete as they finish |
| Token tracking | Monitor token usage per agent and per session — see cost and consumption in real time |
| Session history | Full-text search across all past sessions with auto-summaries, tags, and notes |
| Git integration | Tracks commits, branches, and changed files per agent session |
| Webhooks | Notifications to Slack, Discord, or any HTTP endpoint |
Frameworks like AutoGen and CrewAI help developers build agent pipelines in code. Coral is different — it's an operational tool that coordinates existing, independent agent processes and gives you one place to see and control everything.
| Coral | Claude Code | Cursor | AutoGen | CrewAI | |
|---|---|---|---|---|---|
| Multiple agents in parallel | ✓ | Limited | ✓ | ✓ | ✓ |
| Isolated execution environments | ✓ | ✓ | ✓ | — | — |
| Works with any CLI agent | ✓ | — | — | — | — |
| Real-time monitoring dashboard | ✓ | — | IDE only | — | — |
| Inter-agent message board | ✓ | Basic | — | API-level | API-level |
| Sleep & wake with full state | ✓ | — | — | — | — |
| Search chat history | ✓ | — | — | — | — |
| Dynamic team composition | ✓ | Limited | — | ✓ | ✓ |
| Process-level isolation | ✓ | ✓ | ✓ | — | — |
| Open source | ✓ | — | — | ✓ | ✓ |
Full documentation at cdknorow.github.io/coral.
We welcome contributions! Whether it's adding support for new AI agents, improving the dashboard, or fixing bugs — please open an issue or submit a pull request.
Apache 2.0 License. See LICENSE for details.
