Usage

The usage bar tells you how much of your plan is used. The Usage view tells you what used it: which sessions, projects and models, in the current 5-hour window, the last 24 hours, or the last 7 or 30 days. It counts every session, also the ones you started with claude in a terminal.

It shows tokens and shares. It never shows prices or dollars: your plan is a subscription.

Open it

• Click a usage bar: the one under the message box, the one in New session, or a profile’s card on Home. The view opens for that bar’s profile. The bar’s tooltip says Click to see what used it.
• In the command palette: Open usage. It has no key by default.

It opens in the window like Home. Back or EscapeEsc returns to where you were, and so does your mouse’s back button.

The header

• The profile menu picks whose usage you see. Each profile has its own login and limits. Profiles that share a config folder are counted once. See Claude profiles.
• Plan usage updated 1m ago says when the plan numbers were last checked. The refresh button checks now.
• Limits and Tokens are the two tabs. The period on the right applies to both: Current window (5h), 24 hours, 7 days or 30 days. Switchboard remembers the tab and the period.

Keys	Does
Command, 1⌘1Control, 1Ctrl1	Show Limits
Command, 2⌘2Control, 2Ctrl2	Show Tokens
11 to 44	Pick a period
EscapeEsc	Back to where you were

Limits

One card per plan window: Session (5 hours), Weekly (all models) and a model’s own weekly limit when you use it, such as Weekly · Opus.

• The large number is what is left.
• The bar’s striped part is what you used. It comes back at the reset.
• Under the bar: how much is used, and when the window resets, such as Resets in 2h 14m · 19:30.

A card turns orange when 20% or less is left.

% used over time

A line per window shows how its % used went up, with a dashed line at each reset. Hover the chart to read every line at that moment. At 7 and 30 days the chart shows only the weekly windows; the 5-hour session shows at 24 hours and less.

Switchboard records your plan % each time it checks, so the chart starts the day you install this version. The subtitle says when, such as recorded since Oct 12. Until there is something to draw, the chart says History starts now. At 7 and 30 days it waits for a day of readings; pick 24 hours to see them sooner.

What used this window

The sessions that used the current 5-hour window, with their project, model and share. The top five are listed, the rest fold into one line. Click a session to open it.

Tokens

• The totals: all tokens in the period, the sessions and turns, and each type of token with its part of the whole.
• Cache hit rate: cache reads out of all input. A low rate means the cache keeps being rebuilt, for example after a long break in a session.
• Tokens per day (per hour for 5 hours and 24 hours), stacked by type. Cache reads are most of the tokens and would hide everything else, so the chart starts at Without cache reads; All tokens adds them. Hover a bar to see every type for that day.

Each chart has Show as table for the same numbers as a table.

Breakdown

Group the tokens by Session, Project, Model or Day, and filter the list by name, project or model.

• The session rows show the turns, output, cache write, cache read, the largest context of one turn, and the share. A bolt marks sessions with fast mode turns, which use the plan faster.
• Click a session to open it.
• With Auto model, each model’s row says how many of its sessions Auto picked (“11 by Auto”), and Haiku’s routing calls get their own row, Auto routing, with how many picks it made.
• Questions you ask with Ask about this session get their own row, Side questions, with how many there were. Claude answers them from a short-lived copy of the session, which leaves no transcript, so Switchboard counts their tokens itself.
• The Haiku calls that write catch-up summaries get their own row too, Catch-up summaries, with how many there were.
• Click a model for its tokens, sessions, fast mode turns, largest context, and its cache hit rate over the period.

How shares are counted

Claude doesn’t report usage per session, so every Share (est.) is an estimate. Click the column’s header for how it works:

• Tokens weigh differently against your plan. Compared to input, a cache write counts 1.25×, a cache read 0.1× and output 5×.
• When only one session ran, the share uses the measured change in plan % (from Claude Code’s rate-limit updates during that session’s turns). Otherwise it is the estimate.

A share is a session’s part of the period’s activity, never a part of a limit.

When you hit a limit

When a session stops because your plan’s usage limit is reached, a notice above its message box says which limit, when it resets and how long that is: 5-hour limit reached. Resets at 15:16 · in 4h 42m. The countdown keeps up as you wait. When Claude Code gives no reset time, the notice only says the limit was reached.

• Resume now sends Claude Continue where you left off. right away.
• Resume when it resets sends the same message by itself, 30 seconds after the reset (right at the reset, Claude can still refuse). The notice then says Resumes at 15:16, with Cancel. It also works when you quit Switchboard in between: the session resumes when you open it again. If the limit still holds when it tries (the reset moved), it waits for the new reset, three times at most, and then says it couldn’t resume.
• You get a notification when a session resumes this way, Resumed after the usage limit reset, and one when a limit stops a session, Usage limit reached.

The limit belongs to your Claude profile, not to one session. While it holds:

• Messages in a session’s Up next wait instead of being sent into the limit. Up next says Held: usage limit, and the notice says how many are held. Resuming lets them go once a turn gets through.
• Other sessions of the same profile show the limit above their message box too.
• The queue holds new sessions for that profile until the reset.
• Sessions of another profile go on as usual.

To have every stopped session resume by itself, set Resume after a usage limit resets to Always in Settings › Conversation.

With an API key, Amazon Bedrock or Google Vertex there are no plan limits, so none of this shows.

Where the numbers come from

Note

The first time, Switchboard reads all your transcripts to count their tokens: Reading transcripts shows how far it is, and the numbers grow as it goes. After that it only reads what is new.

• Tokens come from Claude Code’s transcripts, in each profile’s config folder. Each answer from Claude counts once, also when Claude Code writes it on several lines. Subagents count for the session that started them.
• Claude Code deletes old transcripts after a while (30 days by default). The totals Switchboard counted stay, so 30 days stays complete.
• The plan % comes from the same check as the usage bar. No extra checks are made for this view.