All features
Switchboard does a lot more than list your sessions. Skim this page to find what you didn’t know was there. To learn it step by step instead, start with Install or one of the guides.
New lately
Section titled “New lately”- Saved promptsNewSave a prompt with blanks, pick it with / or in New session, fill in the blanks and send.
- CommandsNewSee the commands Claude runs in the background in a panel next to the conversation, with their command line, how they ended and their output.
- Claude Code modsNewPlugins that add UI to your sessions. Switchboard draws their bands, panes, statuses and toasts, each with the mod's name.
- Sessions in their own windowNewOpen a session in a window of its own, next to the main window or on another screen.
- Clone from GitHubNewStart a project from a GitHub URL. Switchboard clones it into a folder you set, adds it as a project and runs your first prompt there.
- Other computersNewFollow and steer the sessions of a paired computer from Switchboard on this one, in the same sidebar, and start new sessions there.
Get started
- Install SwitchboardInstall Switchboard on a Mac, a Windows PC or Linux, with Homebrew on a Mac, or build it yourself.
- First launchWhat you see when you open Switchboard for the first time, and how to add your projects.
- Your first sessionStart Claude Code on a project, and follow it while it works.
- Things to try nextA dozen features that are easy to miss after your first session, each with the page that covers it.
- Switchboard on WindowsEverything that works differently when you run Switchboard on a Windows PC, with links to the pages that cover it.
- Switchboard on LinuxEverything that works differently when you run Switchboard on Linux, with links to the pages that cover it.
Start a session
- New sessionPick a project, choose where Claude works, write the first prompt and start.
- Model, effort and modeThe chips under the message box that set the profile, model, effort and permission mode of a session.
- Auto modelLet Haiku read the first prompt of a new session and pick Haiku, Sonnet or Opus for it. Picked once, shown in the session, easy to undo.
- WorktreesStart a session in an isolated copy of the repository on a branch of its own, like claude --worktree.
- Quick questionsAsk Claude something without picking a project, in a scratch folder of Switchboard's own.
- QueueKeep prompts to start later, in the order you want them, and see when each one is ready.
- SchedulesStart a session from a prompt once, or at set times every day, on weekdays, on the days you pick or once a month.
- Saved promptsNewSave a prompt with blanks, pick it with / or in New session, fill in the blanks and send.
- LinksOpen Switchboard from a switchboard:// link, to start a session with a prompt or jump to an existing one.
Stay on top
- The sidebarThe list of all your sessions, grouped by what needs attention first.
- Session statesWhat the colours, rails and dots on a session mean.
- HomeOne view of what needs you, what is working, your queue, your schedules and your projects.
- UpcomingOne view for everything queued and scheduled, across all your projects, with the scheduled runs of the next 7 days.
- Catch-upA short briefing over a session when it finishes, so you can decide what to do next in a few seconds.
- SearchSearch every conversation, or find words in the one you are reading.
- Notifications and soundsTurn notifications and sounds on or off, each on its own, and pick a sound for each moment.
- Focus limitSet how many sessions you want going at the same time, and get asked before you start one more.
Inside a session
- Working in a sessionChat with Claude, follow what it does, and go back in time when you need to.
- Permissions and questionsApprove or deny what Claude wants to do, answer its questions and review its plans, right in the conversation.
- Ask about this sessionAsk Claude about the session in a panel next to the conversation, while it keeps working. Nothing is added to the conversation.
- Link sessionsMention another session with @ in the message box, and Claude gets its folder, branch, pull request, what it did and its last reply. Stack a pull request on another one without copying anything over.
- GitHub issues and pull requestsType
- AgentsSee the agents Claude started in a session in a panel next to the conversation, with what each one is doing, asked and reported.
- CommandsNewSee the commands Claude runs in the background in a panel next to the conversation, with their command line, how they ended and their output.
- Claude Code modsNewPlugins that add UI to your sessions. Switchboard draws their bands, panes, statuses and toasts, each with the mod's name.
- ChangesThe Changes panel shows a session's git diff, and lets you stage, unstage and revert files.
- GitThe branch in a session's header, the git button with the next step for the branch, pull request checks, and finishing a worktree.
- TerminalA built-in terminal for each session, opening a shell in the session's folder, and one for the rest of the app.
Arrange your sessions
- Split viewTile sessions next to each other and above each other, drag them into place and resize them.
- Sessions in their own windowNewOpen a session in a window of its own, next to the main window or on another screen.
- Pinned sessionsKeep the sessions you come back to at the top of the sidebar.
- Archived sessionsWhere quiet sessions go, how to archive one yourself, and how to delete sessions for good.
- Unsent messagesWhat you type and don't send is kept, also after you quit, and easy to find again.
Projects
- ProjectsAdd, order, rename and remove the folders you work in, and open each project's own page.
- Clone from GitHubNewStart a project from a GitHub URL. Switchboard clones it into a folder you set, adds it as a project and runs your first prompt there.
- OverviewA project's Overview tab shows one card per area, each opening its own tab.
- SessionsA project's Sessions tab lists its sessions the way the sidebar does, with its queued prompts, schedules and archived sessions.
- WorktreesSee every worktree of a project, which ones can go, and remove several at once after one confirmation.
- BranchesSee every branch of a project, here and on the remote, switch between them, and delete the ones you no longer need.
- MemoryA project's Memory tab lists what Claude Code remembers about it, next to its instructions and your personal memory.
- Project actionsOne-click buttons for the commands and prompts you run over and over in a project.
- Project settingsThe Claude profile and the choices new sessions in a project start with, and its name and icon in Switchboard.
Memory and knowledge
- Claude Code memoryWhat Claude Code memory is, where it lives, and how Switchboard lets you read and edit it.
- What loads in a sessionSee every file Claude Code reads at the start of a session in a project, in order and by size.
- Add and edit memoryEdit a memory, write a new one, or save part of a conversation as memory with Remember this.
- Links and searchLink memories to each other with [[name]], and search memory next to your conversations.
- Share with the teamTurn a private memory into project instructions, or copy a section of the instructions to your memory.
- Personal memoryOne folder of memory about you that loads in every project, with any Claude profile, and can sync to your other computers.
- Import from the Claude appBring the Claude app's memory into Claude Code from its data export or pasted text, or copy memories back to the app.
- Memory healthFind memories that point at things that are gone, say the same thing, or don't fit in what loads, and fix them.
Accounts and usage
Work from anywhere
- Remote on your phoneFollow your sessions from your phone, answer Claude when it needs you, and send prompts, wherever you are.
- Other computersNewFollow and steer the sessions of a paired computer from Switchboard on this one, in the same sidebar, and start new sessions there.
- VS Code companionSend what you're looking at in VS Code to a Switchboard session, and answer its prompts from VS Code.
Make it yours
- Built-in themesPick light or dark mode and one of the themes that come with Switchboard.
- Custom themesImport, export, duplicate and edit theme files, and write a theme of your own.
- Code and terminal coloursHow a theme colours code blocks, diffs and the terminal panel.
- Back up and move your settingsExport your Switchboard setup to a file and import it on another computer or after a reset.
Reference
- Command paletteRun any command, jump to a session or project, and start a new session from the keyboard.
- Keyboard shortcutsEvery keyboard shortcut in Switchboard, grouped by where it works.
- SettingsEvery section of Settings and what each control does.
- SessionsWhen finished sessions are archived, moving old archived sessions to the Trash, Claude Code's own cleanup, and an overview of every session.
- UpdatesHow Switchboard keeps itself and the Claude Code it runs up to date.
- Troubleshooting and FAQWhat to check when something doesn't work, where your data lives, and answers to common questions.
- ChangelogWhat changed in each Switchboard release.