Lampboard

LampBoard

A floating column of traffic lights that tells you, at a glance, what state your coding sessions are in — Claude Code and Codex, in VS Code, in a terminal, in a desktop app, on another machine. One traffic light per project, and beside each one a ring saying **how much room that conversation has left**. You click it and you're in that window, or that tab.

It comes from a concrete problem: with a dozen editor windows open, finding out which one is waiting for an answer and which one is still working means going through all of them.

The two questions it answers that a list of sessions does not: *how much context is left in there*, and *has it really finished* — a turn can hand back control while three background agents keep working for another forty minutes.

Six projects, six states, and a ring on every row. The letter in the ring is the model — `S`onnet, `O`pus, `H`aiku, and `G` for the GPT family on the Codex row at the bottom. That picture is not a screenshot somebody took: `Scripts/make-screenshots.sh` runs the real app against a temporary home full of invented projects and captures its window, so the image can never contain anybody's real work and never falls behind the panel it shows.

**Need to get your hands dirty?** The complete technical documentation lives in **[docs/](docs/)**. If you only have time for one file, read [docs/07 traps](docs/07-traps.md): it is the catalogue of defects already paid for, and each one is a day you won't have to spend again.

The states

Color	State	Meaning
🟠 blinking amber	awaiting	Claude is waiting for an answer from you — a permission, or a dialog opened by an MCP server. It is the only state that blocks the work, and the only one that blinks.
🟢 green	ready	The turn has finished: there is an answer to read.