Skip to content

cdknorow/coral

Repository files navigation

Coral: Multi-agent orchestration for AI coding tools.

GitHub Stars Apache 2.0 License Documentation Discord

Quick StartDocumentationFeaturesHow It WorksDiscord


Watch Coral in action

What is Coral?

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.

Coral Dashboard

Quick Start

Download a release

Download the latest binary from GitHub Releases:

  • macOS: Coral.dmg (universal binary)
  • Linux: coral-linux-amd64.tar.gz

Build from source

cd coral-go
make build

Run

./coral

Open 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.

How It Works

1. Create a team

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.

2. Agents work in isolated worktrees

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.

3. Agents communicate via the message board

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.

4. You monitor and steer from the dashboard

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

Features

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

Comparison

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

Documentation

Full documentation at cdknorow.github.io/coral.

Contributing

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.

License

Apache 2.0 License. See LICENSE for details.


Star the repoJoin DiscordRead the docs

About

Unified Agent Dashboard and History

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors