LampBoard guide
Everything the panel can tell you, and everything it cannot. 33 pages.
Start here
What it is, getting it running, what it asks for.
- What LampBoard isA column of lamps that floats over your Mac, one per project, so you stop opening windows to find out what your agents are doing.
- Installing itThree lines with Homebrew, or a disk image, then open the app: its welcome window connects your agents. One step for Codex that nobody can do for you.
- What it asks forA connection you press for, Accessibility when a click first needs it, and the asks of your sessions, which can open under their own rows.
- The first minuteA welcome window of seven screens on your own sessions, three sample rows when you have none at hand, and a tip the first time something happens.
- What LampBoard can doEvery capability in one sentence, sorted by what you want rather than by where it lives, each with a way to try it or turn it on.
- How it comparesClaude Code's own Agent View and the newer agent teams, as each described itself in early October 2026, and where LampBoard differs.
Reading the column
Every mark on a row, and what it promises.
- Anatomy of a rowFive cells, each answering a different question, and a second line that says what the session is doing now.
- The six lampsNeeds you, done, stopped, working, paused, resting: what each one means, why only one of them blinks, and why rest is a grey ring.
- The context ringHow much room is left in a session, which model is holding it, and the three different kinds of silence.
- The cardRest the pointer on a row and the panel tells you everything the row could not fit.
- One row per projectTwenty-two sessions across twelve windows became twelve rows. What that costs, and what it protects.
- Usage leftHow much of your plan remains, in a strip under the rows: what it asks for, and why it is off until you turn it on.
Working with it
The click, the menus, the keyboard.
- Clicking a rowOne click gets you into that window, marks what you saw, and never takes focus on the way.
- The row menuRight-click a row for the Hub first, then where its session lives and what can start beside it, with the ways of keeping it quiet under Quiet and the rarer things under More.
- The bar, the foot and the ⋯ menuThe bar above the rows counts what waits, the strip under them narrows and moves the panel, and the ⋯ menu holds the eight things of every day.
- SettingsOne window of nine sections holds every switch, each with one name and a line under it saying what it does.
- The menu bar lampOne lamp beside the clock, and a panel that can live under it instead of in a window of its own.
- Order, slots and the keyboardThe column never reorders itself, so the third row is the same project tomorrow, and a key you press blind is right every time.
- Being told when you are awaySessions that need you or stopped, finished ones only if you ask, a voice, focus, and what the rows no longer show when you come back.
- LampMasterThe reviewer: a look across all your sessions at once, for the links none of them can see, off until you switch it on.
Beyond one window
Terminals, other machines, the extended window.
- Sessions in a terminalAn agent started by hand in a folder no editor has open, and how the click finds its tab.
- Sessions on another machineAn always-on box over ssh, heard through a tunnel this app opens, with its own row and its own limits.
- The live viewA session's own terminal in a window of its own, the one the Hub shows at its centre: its real Claude Code interface, closed again without stopping the session. Here or on another machine.
- Sessions in the Claude desktop appLocal conversations get a row with a colour read from the transcript. Cloud ones are not here at all.
- Any long job as a rowlampboard watch puts a build, a deploy or a test run in the column, beside the sessions.
- The HubEvery session in one window. The one you choose runs at the centre in its own terminal, Claude Code itself; beside it, its project's files, a file or a shell. Projects and LampMaster are on the left.
- Reading and writing in the HubHow a conversation is read and written from the Hub, and what is never sent for you: text waits in the session's terminal until you press Enter.
Keeping it honest
Limits, updates, when something is wrong.
- What it cannot seeThe list that costs you when nobody writes it down. Measured on 30 August 2026.
- When something is wrongFour commands that say which link in the chain broke, instead of leaving you staring at an unlit lamp.
- UpdatingIt asks before it replaces itself, and proves four things about the download before touching the copy you are running.
- Removing itFour commands in this order, because the second one needs the app to still be there.
- The LampBoard helperA small Claude Code plugin that tells the panel what only the session knows, lets you answer from the panel, and what it does not do.
- Why you can let it near your sessionsWhat leaves the Mac, what proves what, and the gates that fail on purpose before every release.