The parts
Hooks up, typing down
Two flows keep the room alive. Up: hooks. Claude Code hooks tell the relay what each session is doing. The hook trims each event before it leaves: the first two words of a command, short file paths, and no prompt text unless you turn that on. It runs in the background, except forSessionEnd, which runs before the session ends with a 5 second limit. It gives up on the relay after one second and always exits 0, so it never slows Claude Code down.
Down: typing. The relay types briefs, review news and other messages into sessions. Text and Enter answer whatever is on the screen, so a message typed on a guess could approve a command nobody read. The relay types only when hooks say the turn has ended, no menu or question shows, and nobody has text in the session’s prompt. It checks again right before Enter. Silence never counts as idle.
What you see in the room
Each hook event moves the person who holds that session.Is a session alive
One part of the relay answers this for the whole room, from everything it sees of a session together:- Working: in a turn, and a hook came recently.
- Quiet: in a turn with no hook for the stall time, but its screen still moves.
- Stuck: in a turn with no hook and no output for the stall time, 30 minutes unless you change it.
- Job: out of a turn, but a command it started, such as a test run in the background, still runs.
- Gone: its process ended, or it was stopped.