Switch to another account
- macOS
- Windows
- Linux
Click Pitboard’s item in the menu bar, then choose the account.In Accounts, click Switch on the account’s row, double-click the row, or select it and press Return.
pitboard use with the account’s label, such as work, codex/work or, on macOS, desktop/work. Labels says how Pitboard matches a label.
Switched Claude Code to work.
Switch from search, Shortcuts or the taskbar
- macOS
- Windows
- Linux
In Shortcuts, add Switch Account from Pitboard’s actions to a shortcut, then click its account and choose one.On macOS 26 and later, Spotlight runs Switch Account too: press Command-Space, enter
switch account, then choose the account.Pitboard says what it did, such as Switched Claude Code to work. If the ChatGPT app or Claude has to quit first, it asks, as in Quit ChatGPT to switch?: click Quit ChatGPT and Switch. On macOS 14, it says to open Pitboard instead: switch there. If Pitboard cannot switch, the shortcut stops with why, as Shortcuts and Spotlight lists.What Pitboard checks first
Pitboard moves nothing until the account has a parked login and the tool is signed in to an enrolled account, or to nothing. For Claude Code and Codex, Anthropic or OpenAI first confirms over the network that the parked login works and is that account’s. A Claude Desktop switch needs Claude closed instead. An expired or refused parked login needs a sign-in again. Error and warning codes lists every refusal.pitboard use with the account in use moves no login: it only corrects Claude Code’s config when that names another account.
Replace a login Anthropic refuses
When Anthropic refuses for good the login Claude Code has in use, that login no longer works and cannot be parked. A switch asks before it puts the other account’s login in its place. Replacing the refused login loses nothing. In the app, click Replace when Pitboard asks Replace Claude Code’s sign-in?. On Windows, select Replace.pitboard use asks the same at a terminal, ending with Put work's login in its place? [y/N]. Without a terminal, or with --json, it refuses with live_login_refused until you add --yes:
What happens to open sessions
How open sessions follow a switch says why, and what was measured on each system.
On macOS, while a login file sits behind the keychain, open Claude Code sessions follow only at their next renewal or restart. On Windows, the same holds for a login file behind Credential Manager. Put it away as Claude Code over SSH uses another account says.
Get a notification before a limit runs out
While the app is open, it notifies you once a limit of the account in use reaches a share you choose, 95% at first. Where another account of that tool is under the share in every limit, the notification’s Switch button switches to it.- macOS
- Windows
- Linux
In Settings > Limits, choose Notify Me in When a limit reaches. Set the share in At, in its field or with its stepper. Do Nothing turns the notification off.