Quickstart

You need Claude Code signed in to one of your accounts. If it is not, run claude and sign in.

Add accounts only through Pitboard, never with Claude Code’s /login. It replaces the login in use without Pitboard parking it, so that account needs a browser sign-in again.

In the app

macOS
Windows
Linux

Install

Download the app from Download Pitboard, move Pitboard.app to your Applications folder, then open it. The first time, it opens its welcome window.

Add the account you are signed in to

Click Add beside Claude Code. Keep the name Pitboard suggests in Name This Account, or enter another such as personal, then click Done. Click Continue to open Accounts.

Add a second account

Click Add Account in the tip Add a second account, then click Sign In. Sign in as your second account in the browser that opens. If a Code field appears, paste the code the page gives you, then click Submit Code. Keep the name Pitboard suggests, or enter another such as work, then click Done.

Switch

Click Pitboard’s item in the menu bar, then choose work. Under each account, the menu shows how much of each limit it has used, such as 5-hour 12% used, Weekly 40%.

Install

Download the installer from Download Pitboard and open it, as Install the app shows. Once it finishes, Pitboard opens its welcome window. Its icon starts among the hidden icons of the notification area.

Add the account you are signed in to

Select Add beside Claude Code. Keep the name Pitboard suggests in Name this account, or enter another such as personal, then select Done. Select Get started to open Accounts.

Add a second account

Select Add account in the tip Add a second account, then select Sign in. Sign in as your second account in the browser that opens. If a Code field appears, paste the code the page gives you, then select Submit code. Keep the name Pitboard suggests, or enter another such as work, then select Done.

Switch

Right-click Pitboard’s icon in the notification area, then select work. Each account shows how much of its fullest limit it has used, such as work (12%). Point to it to see each limit, such as 5-hour 12% used, weekly 40%.

Install

Set up Pitboard’s repository and install pitboard-app, as Install the app shows, then open Pitboard from your desktop’s apps. The first time, it opens its welcome over its window.

Add the account you are signed in to

Click Add beside Claude Code. Keep the name Pitboard suggests in Name This Account, or enter another such as personal, then click Done. Click Continue to show Accounts.

Add a second account

Switch

In the Pitboard window, click Switch in work’s group. Under each account, its rows show how much of each limit it has used. Where the desktop shows Pitboard’s tray icon, its menu lists the accounts too.

On the command line

Install

On macOS, or on a Linux distribution Pitboard’s repository does not cover, install the command line with the script:

curl -fsSL https://usepitboard.com/install.sh | sh

If it says ~/.local/bin is not on your PATH, do as it says.If you installed the app on macOS, put its command line on your PATH as Install the app shows, in place of the script.On Linux, the app installs the command line with it, so skip the script. On the distributions the repository covers, the command line alone is its pitboard package, as Set up the Linux repository says.On Windows, the app puts the command line on your PATH, where a terminal opened after the install finds it. For the command line alone, follow Install the command line on Windows.

Enrol the account you are signed in to

Pitboard knows each account by a label, a short name you choose. Enrol the account in use as personal:

pitboard enroll personal

Enrolled personal ([email protected]), the account signed in now.
Add another without signing out of it: pitboard enroll <label> --sign-in

Add a second account

pitboard enroll work --sign-in

Opening Claude Code's sign-in. Sign in as the account to add; the account in use now stays signed in.

Sign in as your second account in the browser that opens. If Claude Code asks for a code, paste in the one the browser shows.

Enrolled work ([email protected]). Switch to it with: pitboard use work

Switch

pitboard use work

Switched to work; personal is parked.
Claude Code sessions already running follow within 33 seconds.

personal’s login stays parked until you switch back with pitboard use personal.

See what each account has left

pitboard

● work      [email protected]  Max 20x  signed in
    5h    █░░░│░░░░░   12%  resets in 3h 00m  28% under pace
    week  ████░░│░░░   40%  resets in 2d 4h   29% under pace

○ personal  [email protected]  Max 20x  ready · good for 26d 4h
    5h    ██████░│░░   59%  resets in 1h 10m  18% under pace
    week  █│█████░░░   73%  resets in 5d 18h  55% over pace

● marks the account in use.
ready means you can switch to the account.
good for 26d 4h is how long its parked login lasts.
5h and week are the five-hour and weekly limits.
│ marks where the bar would reach at an even pace.

For every line Pitboard can show, see Account status.

To add accounts of OpenAI’s Codex CLI or Claude Desktop, see Use Pitboard with Codex and Use Pitboard with Claude Desktop.

Get started

Install and remove

Use Pitboard

Troubleshooting

How it works

Reference

In the app

On the command line

​In the app

​On the command line

In the app

On the command line