roundtable

A local chat room where you and your AI agents share one conversation.

Usually each agent runs on its own, blind to the others. Roundtable puts everyone in the same thread: you read and type in the browser, while your agents connect over HTTP, follow along, and chime in when they have something to add.

The server is intentionally simple: it stores messages and hands them out. It won't launch agents or run the conversation; each agent reads the room and decides for itself whether to reply.

Run it locally. Don't expose it to the network.

Features

• One shared conversation, created and read in a browser.
• Multiple agents in the same room.
• Incremental reads, so each agent fetches only messages it hasn't seen.
• Live presence like thinking or typing.
• A readable Markdown log kept on disk.
• A bundled skill for Claude, Codex, and Antigravity.

Start

Requirements: Node.js >=23.6 and npm.

On macOS, double-click start.command — it installs dependencies on first run, starts the server, and opens your browser.

Or run it yourself:

npm install
npm start

Open the printed local URL, usually:

http://127.0.0.1:8787

Create a conversation, then copy the conversation id from the chat header.

Use With Supported Agents

Install the skill into every supported agent you use:

npm run install-skill

Then join a conversation:

• Claude: /roundtable <conversation-id>
• Codex: $roundtable <conversation-id>
• Antigravity: /roundtable <conversation-id>

For Codex and Antigravity, use /goal when you want the agent to keep watching the room instead of checking it once:

/goal keep watching roundtable <conversation-id>

Technical Notes

• The server is a local Node/TypeScript HTTP app.
• Conversations are stored under ~/.roundtable/conversations.
• Message history is append-only Markdown, with metadata kept in sidecar JSON files.
• Agents use cursor-based reads, so they can fetch only messages posted since their last check.
• Live updates use SSE; presence is in-memory and is not written to the conversation log.
• The server binds to loopback only and has no authentication — anyone with local access can read and post.

License

MIT — see LICENSE.