rounds

mcp
Security Audit
Fail
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 10 GitHub stars
Code Fail
  • fs.rmSync — Destructive file system operation in bin/rounds.mjs
  • os.homedir — User home directory access in bin/rounds.mjs
  • process.env — Environment variable access in bin/rounds.mjs
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

A local canvas of everything your Claude Code sessions make.

README.md

Rounds

Everything your Claude Code sessions make, on one canvas.

The Rounds canvas

Watch the film

I run a lot of Claude Code sessions at once and kept losing track of what each one made. Now it
all lands in one place, and I can leave notes on it.

Try it

npx github:krispuckett/rounds --demo

The demo is six of my public projects and the real notes I left on them. It runs in its own
folder and doesn't touch your setup.

What it does

Screens, pages and pushes from every session, sorted by project.

The Road, one of the projects on the canvas

Pin a note on a screen. The session that made it gets the note, makes the fix and replies.

A note on a screen, with the session's reply

Drag to compare a screen with the one it replaced.

A sky before and after a fix

Step back to any day.

Earlier days stacked behind the current one

Search a session by name to see everything it made, newest first.

Set it up

You need a Mac, Node 20 or newer, and Claude Code.

npx github:krispuckett/rounds init

This adds an MCP server, a skill and two hooks to Claude Code, and asks before each one. Then
open the canvas:

npx github:krispuckett/rounds

This also updates Rounds, hooks included, whenever there's a new version.

To take it all out:

npx github:krispuckett/rounds uninstall

Privacy

Everything stays in ~/.rounds on your Mac, and websites can't reach it. To sort older screens
into topics, Rounds asks Claude Haiku through your own Claude Code, sending each one's caption, session
name and file names.

More

Tools

Sessions post with rounds_post and rounds_change, read notes with rounds_notes and answer
them with rounds_reply. One hook brings each session its notes with your next message. The
other ties posts to their session and notices pushes to main.

In auto mode, Claude Code may ask you before acting on a note. Say yes and it carries on.

Keys

Key Does
T Timeline
← → A day back, a day forward
/ or ⌘K Search
+ − 0 Zoom in, zoom out, fit everything
Space Hold to pan, or to see the before while comparing
Esc Back out

Scroll pans and pinch zooms, in the timeline too; scrolling over its rail moves through
the days. Drop an image or an HTML file on the canvas to add it to a project.

Config

~/.rounds/config.json, every field optional:

{
  "projects": [{ "key": "shop", "name": "Shop", "match": ["shop", "storefront"] }],
  "private": ["acme-internal"],
  "port": 4797
}

projects groups work by words in its session, folder or caption. Anything matching private
never shows up. ROUNDS_HOME and ROUNDS_PORT override the folder and the port.

Develop

npm install
npm run dev     # the canvas, on :4797
npm run eval    # the whole loop with real Claude sessions

License

MIT. Made by Kris Puckett.

Reviews (0)

No results found