Skip to main content

See usage

Pitboard’s item in the menu bar shows the account in use and how much of one limit it has used, such as personal 73%. Menu bar item says which limit.Click the item to open Pitboard’s menu, which lists every account with a line under each, such as 5-hour 59% used, Weekly 73%.For a bar per limit, with when it resets, choose Open Pitboard. Select an account to see, beside the list, how long until each of its limits resets.
The Accounts window listing Claude Code and Codex accounts, each with a bar per limit, how much of it is used and when it resets, and a Sign In button on an account whose sign-in has expired. Beside the list, the account in use with each limit's time left, its email address and its sign-in
On the command line, run pitboard, the same as pitboard status:
With accounts of more than one tool, each tool has its own heading and its own account in use. Account status says what each mark, colour and line means, and what to do about each.

See usage in a widget or from Shortcuts

On macOS, Pitboard’s widgets and the Shortcuts action Get Usage show usage without opening Pitboard. On Windows, Pitboard has neither. On KDE Plasma 6.4 or later, the Pitboard widget shows the accounts and their limits while Pitboard runs. To add a widget, Control-click the wallpaper, choose Edit Widgets, search for Pitboard, then click Account or Accounts. For Notification Center, click Edit Widgets at its foot instead. Account shows the account in use: to show another, Control-click the widget, choose to edit it, then choose the account.
The medium Accounts widget: work, of Claude Code, and main, of Codex, each with a bar and how much is used for its 5-hour and weekly limits, and a countdown to each reset
On macOS 26 and later, the control Account shows an account in Control Center or the menu bar. To add it, click Control Center in the menu bar, click Edit Controls, add Account, then choose the account. A widget shows what Pitboard last read, so its numbers move only while Pitboard runs. Widgets and controls says what each one shows. In Shortcuts, or in Spotlight on macOS 26 and later, run Get Usage. With no account chosen, it gives the accounts in use, a line each, such as work: 5-hour 42% used, Weekly 12%, and hands a shortcut each account’s details.

Read without asking, or ask again

To see the last numbers measured, without asking Anthropic or OpenAI, run pitboard status --offline. It renews no parked login, and each Claude Code or Codex account ends with a line such as measured 14:02, 3m ago · read without asking Anthropic. To ask Anthropic and OpenAI again, even about an account asked moments ago, run pitboard status --fresh, or choose Refresh in Pitboard’s menu (Command-R). On Windows, select Refresh in the Pitboard window, or press F5 there. On Linux, click Refresh in the Pitboard window’s header bar, or press Ctrl+R there. When Pitboard cannot get newer numbers, it shows the last ones with when and why, as in measured 14:02, 3m ago · Anthropic could not be reached. The app shows the reason under the account in the window. Usage shows old numbers says what to do.

Choose what the menu bar shows

On macOS, choose from the Menu Bar Shows pop-up menu in Settings > General to show the percentage alone or the icon alone. Settings lists each choice. On Windows, the icon has no such setting. Its lit row shrinks as one limit of the account in use fills, as Icon in the notification area says. On Linux, the tray icon has none either, and shows the same, as Tray icon says.