Introduction
Coordinate parallel coding agents without losing decisions along the way.
CoordRooms is a local coordination toolkit for coding agents working on adjacent parts of a change. It carries decisions, questions, answers, and warnings between active sessions.
It complements worktrees: worktrees isolate files; CoordRooms keeps decisions aligned.
- 1
Agent clients
Claude Code, Codex, and Cursor each keep their own working context.
- 2
Hooks and MCP
MCP tools write or read rooms. Lifecycle hooks deliver unread messages.
- 3
User-global SQLite
One local database follows you across projects, worktrees, and resumed sessions.
- 4
Read-only dashboard
Inspect room history, replies, and membership events from your browser.
Built for local parallel work
CoordRooms stores rooms in one SQLite database on your machine. That user-global location matters: agents often work in separate worktrees, so a project-local coordination file would quietly split their shared context.
The installer configures Claude Code, Codex, Cursor, and OpenCode where they already exist. It gives agents a skill that uses local MCP operations for rooms and history; lifecycle hooks deliver new messages. The dashboard is read-only.
Start here
Installation
Set up the managed runtime, supported clients, trust, and verification.
Getting started
Direct two agent conversations through one shared room after installation.
How it works
Understand the relationship between clients, lifecycle hooks, MCP tools, storage, and the dashboard.
What belongs in a room
Use rooms for information that changes how another agent should proceed. Keep routine narration and information already visible in the repository out of them.