Running multiple Claude Code sessions? SwitchBoard lives in your macOS menu bar and shows you exactly what each session is doing — working, waiting for approval, or done. No server needed.
v1.1.0 · Free & Open Source · macOS 13+
How It Works
SwitchBoard reads Claude Code’s local session files (~/.claude/sessions/) and checks each process’s status in real time. No API keys, no server, no setup — just install and go.
Status | Icon | Meaning |
| Working | bolt | Claude is actively generating |
| Needs Approval | hand | Waiting for you to approve a tool use |
| Needs Input | keyboard | Claude finished, your turn |
| Done | checkmark | Turn completed |
| Ended | moon | Session process terminated |
Features
Grid & List Views — Switch between a visual grid and a compact list. Drag to reorder sessions your way.
Multi-Channel Notifications — Get notified when a session finishes via macOS notifications, Slack, Discord, or Telegram webhooks. Each channel works independently.
Custom Alert Sounds — 8 fun built-in sounds (Finish!, Ding Dong, Magnificent, Hey Hey Hey…) or drop your own .aiff files into ~/Library/Sounds/. Separate sounds for "done" and "needs input".
Global Shortcut — Cmd+Shift+S toggles the popover from anywhere. Left-click for quick view, right-click for full dashboard.
Session Search & Notes — Filter sessions by project name or custom notes. Add memos to remember what each session is doing.
Terminal Integration — Click a session to jump straight to its terminal window (Terminal.app, iTerm2, Warp). Auto-detected via PID parent chain.
Performance Optimized — TTY caching, smart polling skip for idle sessions. 10 sessions go from 40+ process spawns to 5–10 per poll cycle.
5 Languages — Korean · English · Japanese · Simplified Chinese · Traditional Chinese
More Goodies
•
Menu bar badge — Shows active/total session count right on the icon
•
Auto-cleanup — Ended sessions disappear after 5/10/30 min (configurable)
•
Work history timeline — Track every status transition per session
•
Token usage — Parsed from JSONL, displayed in K/M format
•
Always on top — Pin the dashboard as a floating window
•
Kill sessions — Right-click context menu to SIGTERM a session
•
Auto-update — Sparkle framework, checks for updates automatically
Download
Download Latest Release (GitHub)
Code-signed + Apple Notarized — runs without any macOS warnings.
Source Code (GitHub)
MIT License · Contributions welcome!
Made by kkiruk studio · 2026
2026