Switchboard

Every Claude Code session on your machine in one pane, and which one needs you.

See what Claude is doingv0.2.0

Tests48 passing

Model callsnone

Commands1

Settings1

Find sessions that need you

Switchboard shows Claude Code sessions running the mod on your machine and which need attention. Sessions without Switchboard do not appear.

Reported behavior and access

Files `Session status files in your home folder`

Writes one small status file per session under ~/.claude/switchboard and reads the other sessions' files. Runs tail on its own transcript to find the session title.

Shell commands `Subprocesses used`

Writes one small status file per session under ~/.claude/switchboard and reads the other sessions' files. Runs tail on its own transcript to find the session title.

Network `No network`

The reviewed README reports no network requests, including its described subprocess behavior.

Added model calls `None reported`

The reviewed README reports no model calls of its own. Ordinary Claude Code work still uses your model.

Sound `Not reviewed`

Behavior has not been source-reviewed for this version. Check the README before relying on its access.

Handled events `config.set "switchboard.enabled", session.start, classic.SessionStart, classic.UserPromptSubmit, turn.start, turn.complete, classic.Notification, tool.call, session.measure, session.end, session.attach, command.run /switchboard, ui.render SessionMode, ui.render AbovePrompt, ui.render Pane`

Event registration does not mean blocking. Read the source for whether an event observes, changes or holds an action.

README-reported behavior, not a sandbox guarantee. Source v0.2.0, d1cbb8d, reviewed 22 Oct 2026

Original Claude Code validator report

writes files

Can read and write files.

commands

Can run commands.

network

Does not make network requests.

model

Does not call a model.

sound

Does not play sound.

Validator hook registrations

Uses hooks: config.set, classic.SessionStart, classic.UserPromptSubmit, classic.Notification, tool.call.

Static validator signals can miss indirect effects, optional configuration and engine-managed storage.

How it works

Slash commands

/switchboard

Every Claude Code session on this machine, and which one needs you

Settings

enabledDefault: true: Switch switchboard off without uninstalling it. The modmyclaude hub flips this too.

Hook events

config.set "switchboard.enabled"session.startclassic.SessionStartclassic.UserPromptSubmitturn.startturn.completeclassic.Notificationtool.callsession.measuresession.endsession.attachcommand.run /switchboardui.render SessionModeui.render AbovePromptui.render Pane

The prompt

switchboard / prompt

Build me a Claude Code mod called "switchboard": a pane that lists every Claude Code session on this machine and tells me which one is waiting on me.

How sessions find each other: each session running the mod writes one small JSON file about itself to ~/.claude/switchboard/<session id>.json (under CLAUDE_CONFIG_DIR when set): its name, its state, where it runs (terminal, desktop or nothing attached), what a dialog waits on, when that state began, when it last had a turn, a heartbeat time, and its cost so far when Claude Code reports one. Never any message text. It rewrites the file when its state changes and every 30 seconds; a file not rewritten for 90 seconds means the session is closed.

The name: the title in the desktop sidebar (a custom-title line in the session's transcript), else the one Claude Code writes (ai-title), else the folder. Read it with `tail -c 262144` on the session's own transcript when it starts and at most every two minutes at a turn's end, keeping only the title lines.

Details

Every Claude Code session on your machine in one pane, and which one needs you.

2 need you
You are here: api-server (terminal)

! Fix the login                                           desktop
    waiting on a permission for Bash · 2m
✕ tests           stopped on an error 5m ago             terminal
● docs            working for 2m                          terminal   ≈$0.49
○ web             idle for 12m                            terminal
○ 26 quiet sessions: idle, no turn in the last hour       [Show]
- old             closed 2m ago                           terminal

Use it

/switchboard opens the pane. The first line says how many sessions need you, and the next one says which session you are in and where.
One row per session, who needs you first: a mark and a colour for its state, its name (the title in the desktop sidebar, or the one Claude Code gives it, else its folder), what it is doing in words, where it runs, and its cost so far when Claude Code keeps that figure.
- ! waiting on a permission (and for which tool), a subagent's permission, a question, a plan to approve, or an answer
- ✕ stopped on an error
- ● working
- ○ idle (or new, opened and not prompted yet)
- - closed (it stopped reporting; listed for an hour)
Quiet sessions (idle, with no turn in the last hour) fold into one line. Show unfolds them; each new start of the session folds them again.
A session waiting on you says what for on a line of its own. On a narrow pane the names shorten first, so the state and where always show.
While another session needs you, a line above your prompt says which and where (! Fix the login needs you (desktop), with Show to open the pane), and the footer counts them (1 needs you). Never for this session's own dialog, which is already in front of you.
A toast the moment another session starts needing you, once per change: Fix the login needs you (desktop).

It only watches. It never switches to, answers or types into another session: go to that session to answer it.

Settings

On: on by default. Off, Switchboard writes no record, reads no other session's and draws no line, footer count or rows; switched off while it runs, its record says closed one last time, so other sessions stop showing this one working or waiting on you. /switchboard says it is off. /config or the modmyclaude hub flips it, live.

What it can touch

Writes: one small file for this session, ~/.claude/switchboard/<session id>.json (or under CLAUDE_CONFIG_DIR when that is set), rewritten when its state changes and every 30 seconds, and once more, as closed, when you switch Switchboard off. It holds the session's name, state, where it runs, what a dialog waits on (a tool's name, such as Bash), three times (when its state began, when it last had a turn, and when the file was written), whether it is new (not prompted yet), and its cost figure. The name is the session's title, which Claude Code writes as a short summary of your first prompt (or you set in the desktop sidebar), else the folder's name. Nothing else of your prompts, Claude's replies or your files.
Reads: the other files in that folder, every 5 seconds while you are looking at this session (a terminal or the desktop app attached) and whenever this session's own state or title changes, only the ones that changed since the last read. Its own session's events: turns starting and ending, the tool a turn calls, Claude Code's own "waiting on you" notice, the session title, and the cost figure.
Runs: tail on this session's own transcript (its last 256 KB) to find the session's title: when it starts, and at a turn's end at most every two minutes. Until the session has a title it also looks at every turn's end, at Claude Code's "waiting on you" notice, at a /clear or resume, and at the first prompt, so a new session gets its name quickly. Only the title lines are kept; the rest is never stored or shown.
Session state: the rows as last read, and whether the quiet ones are unfolded.
Network, model calls: none.

Limits

A session shows up only once Switchboard runs in it. Sessions started before you installed it appear after their next restart, or at once where Claude Code hot-loads the mod into them.
A dialog shows as waiting about six seconds after it opens, when Claude Code raises its own notice; once you answer it, the row says working again after the tool it asked about has run.
A closed session is inferred: one that has not rewritten its file for 90 seconds is shown as closed. A computer waking from sleep shows its sessions as closed for up to half a minute.
A brand-new session shows its folder's name until Claude Code titles it, usually after the first prompt. On a host with no tail (Windows), the title comes only with your next prompt.
Files of old sessions stay in the folder (a few hundred bytes each): Claude Code gives mods no way to delete a file. They are never read once older than an hour, and you can delete the folder at any time.
Two sessions with the same name get the first characters of their ids to tell them apart.
An older session that has had no turn since Switchboard loaded into it counts as quiet, since its last turn is unknown.
The pane, the line and the footer are checked through the engine's test kit on the terminal and desktop surfaces.

Built from a prompt

This mod was built from the Switchboard prompt.

added 12 Oct 2026updated 23 Oct 2026MITSource on GitHub

Pairs well with

ant-farmAnt FarmfootprintsFootprintsheadwayHeadway

Follow modmyclaude for new mods: TikTok · Instagram · YouTube · X · Threads · Facebook

Find sessions that need you

Reported behavior and access

Files Session status files in your home folder

Shell commands Subprocesses used

Network No network

Added model calls None reported

Sound Not reviewed

writes files

commands

network

model

sound

Validator hook registrations

How it works

Slash commands

Settings

Hook events

The prompt

Details

Use it

Settings

What it can touch

Limits

Built from a prompt

Pairs well with

Use it

Settings

What it can touch

Limits

Built from a prompt

Files `Session status files in your home folder`

Shell commands `Subprocesses used`

Network `No network`

Added model calls `None reported`

Sound `Not reviewed`