cc-board

A Mac app that shows every Claude Code session you have running as a card. Whatever finished comes to the front, whatever is still working waits blurred behind it, and a session that stopped says why.

curl -fsSL https://ccboard.dev/install.sh | sh

macOS 13+ on Apple Silicon · free, MIT · source

cc-board in Wall view on a 2560 by 1440 display: four project columns with three cards each. — Wall, on a 2560 × 1440 display. Each project gets its own column.

Cover

One card at a time. The card in front is the session that most needs you. Reply in it and press Return, and the next result comes up. Sessions that are still running stay in the back, blurred, until they finish.

Cards

Each card shows what you asked, the gist of what came back, and where the session stands. When a session stops, the card names the reason it found in the transcript: out of quota, login expired, an API error, interrupted, never finished, or running but quiet for 20 minutes. If you're looking at something else, you also get a notification.

Card: Follow up, asking whether to go with option 1. — Follow up: it asked you something.

Card: To review, dark mode is in. — To review: a finished result.

How it works

It reads the files Claude Code already writes, under ~/.claude, and never writes to them. No SDK, no API proxy, no claude -p.
Every card is a real claude process: a Ghostty tab you opened, or a tmux session cc-board started for you. You can attach to it and take over at any time.
Replies are pasted in and sent with Return, the same as typing. It won't type into a session that is showing a dialog, so it can't answer one for you by accident.
The server listens on 127.0.0.1 only, every request needs a token, and the page loads nothing from the internet.
Start new work with ⌘N or the New task link above a column. Zoom into a card with ⌘O. Archive what's done.

Install

The script checks your Mac, fetches cc-board from GitHub and builds it locally in under a minute. It needs no sudo. Source goes to ~/.cc-board, the app to ~/Applications/总控台.app. Read the script.

curl -fsSL https://ccboard.dev/install.sh | sh

You need Claude Code, Node 22 or later (brew install node), tmux (brew install tmux) and the Xcode Command Line Tools (xcode-select --install). Ghostty is optional; it's only needed to reply into tabs you opened yourself. Or build it by hand:

git clone https://github.com/Lfrangt/cc-board.git
cd cc-board && ./build.sh

Questions

Which sessions show up?: Claude Code running in a terminal. Sessions inside an editor extension don't.
Does it change my Claude Code setup?: No. Your login, settings, hooks and CLAUDE.md stay as they are, and deleting cc-board leaves nothing behind in them.
Intel Macs?: Not yet.
Is it made by Anthropic?: No. It's an independent project.