switchboard (wide3751)

Reviewed at commit e9a0db3

Sends data to GitHub (api.github.com), the current branch's pull request lookup through your own gh login, only when gh is installed

See at a glance which local Claude Code sessions are working and which need you. Opens a board in Claude Desktop or the terminal, with the needs-you count on…

Made by
Eric
What we checked

Adds a board in Claude Desktop or the terminal that lists every local Claude Code session as working, idle or waiting on you; clicking one switches to it. Each session writes a short status file (masked first prompt, last reply, current tool, branch) to ~/.claude/switchboard, removed after the session ends. It runs git and gh for branch and pull request details and checks GitHub hourly for a new version.

Review details

Static review of the source at the pinned commit; not run. hooks.json loads register.tsx, which imports the pure helper files board.ts and i18n.ts (all three read; register.tsx and board.ts in full for everything that touches processes, files, network, environment and settings, the Pane rendering code and i18n.ts strings by targeted search; the unresolved ../types import is type-only, types/index.d.ts is in the bundle). Hooks: session.start, turn.start (first prompt becomes a 40-character topic), tool.call and tool.check (only observe; next(e) is called unchanged, nothing is blocked or approved; an 'ask' verdict is recorded as an approval summary), session.append (background task notifications), turn.complete (120-character reply summary), command.run for /switchboard:open (answered locally, never sent to the model), ui.focus, ui.close, ui.render for an AbovePrompt open button and the board Pane. Each session writes $CLAUDE_CONFIG_DIR or ~/.claude/switchboard/reports/<sessionId>.json via $.fs.write with model, branch, progress, tool summaries, question, last reply summary, usage, rate limits, connectors (from $.tool.list), PR and TERM_PROGRAM; text passes through maskSecrets (best effort masking of tokens, keys, URL credentials, Authorization headers). The board polls every 3 s (15 s light scan otherwise) reading ~/.claude/sessions/*.json and the reports, checks pids with ps -o pid=,tty= (tasklist on Windows), and removes reports of ended sessions older than a minute with rm -f / cmd /c del, limited to names matching [A-Za-z0-9-]+.json in its own folder and skipped when a path has cmd special characters. In each session's working directory it runs git status/merge-base/diff --numstat with core.fsmonitor disabled, --no-ext-diff and --no-textconv, and gh pr view --json number,state,url (5-8 s timeouts). Other programs: uname -s, defaults read -g AppleLanguages for the locale; on click only, open/rundll32 url.dll,FileProtocolHandler for https PR links, the author's GitHub page and claude://claude.ai/epitaxy/<id> deep links (id restricted to [A-Za-z0-9_-]), and osascript scripts that select an iTerm2 or Terminal tab by tty (tty passed as an argument, restricted to ttysNNN). Update check: at most once an hour across sessions, $.http.fetch of its own plugin.json from raw.githubusercontent.com with a 10 s cutoff, no local data sent, off via a setting or DISABLE_UPDATES / CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC; 'Update now' runs claude plugin marketplace update switchboard and claude plugin update switchboard@switchboard only when pressed. Settings and update state live in $.store. Failures are caught and never affect the session. No model calls, no eval or encoded code, no npm dependencies. All of this is disclosed in the README's Privacy and security section.

What it uses
  • Reads your prompts: yes
  • Sees tool calls: yes
  • Blocks or changes tool calls: no
  • Reads or writes files: yes
  • Runs programs on your machine: yes
  • Calls the model (uses tokens): no
  • Sends data over the network: yes
  • Stores data: yes
  • Shows something on screen: yes
Hooked events
Screenshot of switchboard (wide3751)

See at a glance which local Claude Code sessions are working and which need you. Opens a board in Claude Desktop or the terminal, with the needs-you count on the open button.

Made this mod? Add a badge to your README

modsforClaude badge for switchboard (wide3751)

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/switchboard-wide3751.svg)](https://modsforclaude.com/mods/switchboard-wide3751/)

← All mods