- macOS
- Windows
- Linux
Click Pitboard’s item in the menu bar, then choose Settings (Command-Comma). Settings opens in a window of its own, on the pane you used last: General, Limits or Advanced.
General
Open Pitboard at login
On macOS, turned on, it adds Pitboard to macOS’s login items. macOS may want your approval first, and Pitboard does not open at login until you give it. The pane then shows macOS is waiting for you to allow Pitboard in Login Items. and Open Login Items Settings. If macOS refuses the change, its reason shows under the setting.Start when you sign in to Windows
On Windows, turned on, it writes the valuePitboard in your account’s Run key, which starts Pitboard without its window when you sign in.
Where Windows’ own Startup settings turned Pitboard off, the switch is dimmed and reads Turned off in Settings > Apps > Startup, where you can turn it on again. Open Startup settings under it opens that page. Pitboard reads the setting again each time Settings opens, and as you come back to the Pitboard window while it shows Settings.
Start Pitboard at login
On Linux, turned on, it writes an autostart entry, which starts Pitboard with no window each time you log in, as Start at login says.Notifications
On macOS, when Pitboard’s notifications are turned off in System Settings > Notifications, General has a Notifications row that reads Notifications from Pitboard are turned off in System Settings. Its Open Notification Settings opens that page. Pitboard reads it again each time Settings opens, and as you come back to the app. On Windows, when Windows shows none of Pitboard’s notifications, a Notifications card under Start when you sign in to Windows says why. Pitboard reads it again whenever it reads that switch’s setting.Menu bar shows
On macOS, Pitboard’s item in the menu bar shows:
Menu bar item says which account and which limit the percentage follows. On Windows, the icon’s tooltip says the same, as Icon in the notification area describes.
Updates
- macOS
- Windows
- Linux
A copy from a release download or the
pitboard-app cask has these controls:Version names your version, and its Check Now checks at once, in the updater’s own window. Once a daily check finds a newer version, Version reads Pitboard 0.10.1 is ready to install. and Pitboard’s menu offers Install Pitboard 0.10.1.A copy built from source has no update key and cannot update itself. It shows Version alone, with This copy of Pitboard can’t update itself: it was built from source and carries no update key. A copy from a release keeps itself up to date.
Limits
The choice, its share and Use first are kept in
app.json, as The app describes. They stay dimmed until the app has read that file.
When a limit reaches
While the app is open, it acts once a limit of the account in use reaches the share:
On Linux, where the desktop shows no tray icon, Watch in the Background goes on once the window is closed.
At and Use first show under Notify Me and Switch Automatically. At is a field and a stepper on macOS, a number box from 50 to 99 on Windows. On Linux, it is a field with buttons. On Windows, the choices are Do nothing, Notify me and Switch automatically.
pitboard watch never reads this setting.
A note under the choice says what it does. Under Switch Automatically, it says when running sessions follow, as Open sessions explains. Whatever is chosen, Is this allowed? under the choice opens Is this allowed.
Under Switch Automatically, the app decides whether to switch:
- When you choose it or change the share.
- After each usage read.
- After another Pitboard run records a switch or usage.
- At least every 30 seconds.
Automatic switching lists each reason. The menu bar app and the app on Windows list what they post.
Use first
Use first sets which account the app offers and switches to first.pitboard watch takes its own, --order.
Both put an account without a weekly limit for all models, such as a Team seat, first. Which account it switches to gives every rule.
For Codex, which the app never switches, Resets Soonest posts Another Account Resets First under Switch Automatically too. On Windows, the choices are Most left and Resets soonest.
Warm-up
While the app is open, it warms up each Claude Code account turned on here, between From and To each day, as Warm up accounts describes.pitboard warm changes the same setting, and pitboard watch reads it.
To at 00:00 is the end of the day. A From later than To runs past midnight. On Windows, the hours show beside Warm-up, such as 6:00 AM to 10:00 PM, or All day.
Each account’s switch shows where its warm-up stands while it is on, such as Warms up again at 11:45 AM. A line under the list says what comes next:
On Windows, the line sits under Warm-up, and shows while the section is closed.
Advanced
Keep saved sign-ins fresh
Off by default. A note under it reads Your Mac refreshes your saved sign-ins once a day, so one you leave alone doesn’t expire. On Windows, it starts Your PC, and on Linux This computer. Once a Claude Desktop account is added on macOS, it reads Your Mac refreshes saved sign-ins, except Claude Desktop’s, once a day so they don’t expire. It has the system’s scheduler runpitboard renew once a day, with the command line that came with the app. That run refreshes the saved sign-ins that are due and nothing else. Keep parked logins alive says why.
The setting is on whenever the scheduler has the job, including one pitboard schedule install made. pitboard schedule status says where the job is, as Renewal schedule names it. A change that fails says why under the setting.
You can always turn it off. You cannot turn it on in these cases:
Command line
Path shows where thepitboard a terminal would run is, or Not installed. On Windows, the Command line card shows it. A note under it says how that pitboard updates:
- macOS
- Windows
- Linux
Pitboard looks on your login shell’s
PATH, skipping folders that need your permission, such as ~/Documents. It then looks in ~/.cargo/bin, ~/.local/bin, /opt/homebrew/bin and /usr/local/bin.Install Command Line Tool shows only when Pitboard finds no pitboard and the app’s own command line can run. After macOS asks for an administrator’s password, it links /usr/local/bin/pitboard to Pitboard.app/Contents/Helpers/pitboard, as the line beside it says. It replaces a link already there.