Repository navigation
v0.1.0 — the first release
The first release.
Roundtable is a read-only observer for Claude Code. It tails the JSONL transcripts the CLI already writes under ~/.claude and draws the session as a live pixel-art office — every agent a person at a desk who thinks, runs tools, walks over to report a result, and leaves through the door when it finishes.
git clone https://github.com/Kostakurta8/roundtable
cd roundtable && npm install && npm start
No Claude Code session running? npm run demo stages a synthetic transcript root in your temp directory and drives it through the same watcher, parser, socket and store a real session uses. It never reads your own ~/.claude.
Node 22.12+. Written and used on Windows. As of this release CI runs the type check, the unit suite and the production build on Ubuntu, macOS and Windows across Node 22 and 24 — that means it compiles and the suite passes on all three, not that anyone has watched the office draw itself on a Mac. If you run it there, an issue saying what happened is genuinely useful either way.
What it does that a session viewer usually does not
- Deterministic replay. Click any second on the timeline and the room rebuilds exactly as it stood — the same events replayed into the same simulation, not an approximation.
- Per-agent token and cost accounting. Every agent carries its own total, cache included, and a cost estimate from published list prices.
- Strictly read-only. Never writes to
~/.claude, never calls an API, opens no outbound connection at all.SECURITY.mdnames the file and the mechanism behind each of those claims — and the residual risks they do not cover.
Notable in this release
- Continuous integration across three platforms, where previously nothing had ever been run off Windows.
- Sessions are named by what they were asked to do, not just by the directory they run in — several sessions started in the same place used to be six tabs differing by two hex characters.
- File edits show their size —
+12 −3beside the path. An unknown count renders as nothing rather than as zero. - The room has a ceiling. The strip above the office was painted in two near-blacks and read as a broken viewport.
- The CLI's own markup is no longer read out as your words. Feed cards used to render
<local-command-caveat>and<command-name>/effort</command-name>verbatim.
CHANGELOG.md has the full list, including the fixes and the one dependency removed.