A desktop app for Claude Code sessions.
Switchboard lists every Claude Code session on the machine, grouped by project and searchable by content, and runs them in built-in terminals. It launches, resumes and forks sessions, shows which ones are busy or waiting for you, and can observe sessions running on other machines over SSH.
This repository is a fork of doctly/switchboard;
the original app is its author's work. Features move between the two when they
fit. git log --oneline upstream/main..main lists what the fork carries.
| Platform | Files |
|---|---|
| macOS | .dmg or .zip, Apple Silicon (arm64) and Intel (x64) |
| Windows | Switchboard-Setup-<version>.exe (NSIS installer, x64 and arm64) |
| Linux | .AppImage (x64, arm64), .deb (amd64, arm64), switchboard-doctly-<version>.pacman |
The builds are not code-signed. macOS Gatekeeper and Windows SmartScreen warn on first launch.
Switchboard needs the claude CLI on the PATH of your login shell, and reads
its sessions from ~/.claude/projects. Installed builds update themselves; see
Updates.
| Area | Page |
|---|---|
| Sidebar: projects, sessions, filters, search, pin, archive, delete | Session browser |
| Starting, resuming and forking sessions; the New Session dialog | Launching sessions |
| Running several sessions on one repository in git worktrees | Worktree sessions |
Running claude in a bubblewrap sandbox (Linux) |
Sandbox |
| The built-in terminal: right-click, clickable paths, paste, find, panel shell | Terminal |
| The window strip, the menu, zoom and full screen | Window |
| Every open session as a live card | Grid overview |
| Busy, waiting and attention indicators; the status bar | Status indicators |
| Subagent hierarchy, live status, transcripts | Subagents |
| Claude's file opens and proposed edits in a side panel | IDE emulation |
| A session's git changes, with an editor | Changes view |
CLAUDE.md, memory files and .work-files/ |
Agent Files and Work Files |
| Activity heatmap, token counts, rate limits | Stats |
| Reopening the open sessions after a restart | Session restore |
| Sessions on other machines, over SSH | Remote hosts |
| Scheduled headless runs and the file-based trigger API | Automation |
| Reporting session time to ActivityWatch | ActivityWatch |
| Debug mode and the activity trace | Activity trace |
| Every setting and its default | Settings reference |
| Every keyboard shortcut | Keyboard shortcuts |
The full index is docs/README.md.
- Development: prerequisites,
taskcommands, running from source next to an installed copy, building, project layout. - Testing a PR live and live testing with a throwaway HOME.
- Releasing: the version bump, the tag, publishing the draft release.
- Contributors and agents working in the code: .ai/shared-guidelines.md
(included by
CLAUDE.md) and .ai/contexts/.