Interface And Keys

Interface and keys

clauth opens on the Overview tab. ← → move between tabs, ? lists every binding for the tab you are on, q twice quits.

Tabs

Tab	Holds	You can
Overview	account table, live 5h / 7d bars, chain position	switch accounts, reorder them
Usage	per-account window breakdown: 5h, 7d, per-model weeks, extra-usage spend, endpoint, merged env	refresh one account, toggle estimates and the pace marker
Tokens	global Claude Code token stats and API-equivalent cost	drill into models, change the period lens, count cache tokens
Setup	per-account endpoint, key, env, model routing, auto-start	edit any of it, log in, log out, disable, delete
Fallback	the auto-switch chain	reorder members, edit thresholds, flip gates, set a spend ceiling
Config	program-wide settings	change any of the rows in the table below
Status	incidents from status.claude.com with per-component health	open an incident's timeline or its page in a browser
Plugin	Claude Code wiring health and per-profile runtime state	apply one-key fixes

The active account is orange. Usage numbers are cached on disk, so they stay on screen when the API is rate-limited or unreachable.

Keys

Everywhere

Key	Action
← → (tab / ⇧tab at the top level)	previous / next tab
↑ ↓	move the selection, or scroll a detail pane
⏎	act on the selected row (see below)
n	new account
d	open the divergence resolver, when one is pending
x	dismiss the newest toast, then the footer alert
a	action menu for the current row
?	keybinding help for this tab
esc	step back out of a sub-pane
q	step back, or arm quit at the top level; press again to confirm
ctrl+c	quit from anywhere

Tab-dependent

Key	Behavior
r	Usage: refresh the selected account only. Tokens / Status / Plugin: reload that tab's data. Everywhere else: refresh every account
t	Tokens: cycle the period lens. Everywhere else: force-rotate every account's token, after a confirm
⏎	Overview: switch to the selected account. Tokens: open the model breakdown. Setup / Fallback: open a detail row, or commit an edit. Status / Plugin: open the detail
⇧↑ ⇧↓	Overview: reorder accounts. Fallback (chain focus): reorder chain members
space	Config: cycle a value. Setup model row and Fallback toggle rows: flip
+ -	Fallback detail: step rotate at or weekly at by 5
e	Usage: toggle burn estimates
p	Usage: toggle the ideal-pace marker
c	Tokens: count cache reads and writes in the token totals
f	Plugin: apply the selected row's fix

On macOS, t skips any account holding a live clauth start session: that session's login lives in a Keychain item clauth cannot write, so rotating it would sign the session out.

Action menus

a opens the actions available for whatever is selected. Config and Plugin have none.

Tab	Entries
Overview	switch to selected, new account, refresh usage, rotate access token
Usage	refresh usage, toggle estimates, toggle pace marker
Tokens	period: lifetime / daily / weekly / monthly, show all models / show claude models / show other models, toggle cache counting, reload stats
Setup (account list)	configure, new account
Setup (a settings row)	the row's own action: edit field, remove field, toggle auto-start, log in, log out, disable account / enable account, delete account, create account
Fallback (chain)	open, reorder up, reorder down
Fallback (member detail)	edit threshold, edit weekly at, toggle weekly gate, toggle scoped gate, toggle last resort, toggle preferred, edit max auto-spend, remove member
Status	refresh status, open in browser

The active period or model filter is omitted from the Tokens menu, so the entries you see are the ones that would change something.

Setup tab rows

Row	Sets
name	the profile name
auto-start	whether clauth opens the 5h window with a 1-token ping (Configuration)
base url	the API endpoint; blank means an OAuth account
api key	the key for that endpoint
model	the account's default model; space cycles presets, ⏎ types a full id
+ model override	expands to opus, sonnet, haiku, subagent id overrides
env entries	extra environment variables merged into settings.json while this account is active
disable account / enable account	hides the account from auto-switch and polling, keeping its files
+ login / re-login	browser OAuth login for this profile
log out	drops the stored credentials, keeps the profile
token	read-only state of a stored long-lived setup token: its remaining life, or expired / mis-filled with the fix beneath it (Configuration)
clear long-lived token	drops that token so the account's own OAuth login installs again; appears only when one is stored, arms on the first press, clears on the second. Faint and inert when the account has no other login to fall back to
delete account	removes the profile; arms on the first press, deletes on the second

Config tab rows

Row	Options	Default
theme	full, compatible	auto-detected
reset display	relative, clock, both	relative
clock	24h, 12h	24h
on mismatch	ask, overwrite, new, discard	ask
refresh	15 / 30 / 60 / 90 / 120 / 300 s, or a typed value from 10 s to 1 h	90s
refresh spent	keep polling accounts already at 100%	on
rotation	preemptive, lazy	preemptive
weekly limit	chain-wide 7d exhaustion line, 50-100%	98%
switch mode	static, burn-aware	static
burn floor	earliest projected-switch point, 90-100%	98%
burn horizon	how far ahead burn-aware projects	60s
quota spent	stay on active, switch off all	stay on active
allow extra usage	off, pay-as-you-go	off
extra usage spent	stay on active, switch off all	switch off all

clock is inert unless reset display shows one. burn floor and burn horizon are inert unless switch mode is burn-aware. extra usage spent is inert unless allow extra usage is on. What each of the auto-switch rows does: Auto-switch.

Plugin tab

Each row is a check on your Claude Code wiring: clauth on PATH, the mcpServers entry, the plugin install record, claude --version, and each profile's runtime state. f applies a fix on rows that offer one, behind a confirm that defaults to cancel:

Fix	When it appears
wire mcpServers into ~/.claude.json	the entry is missing, project-local only, or points somewhere stale
repair credentials	the active profile's stored login disagrees with the live one
relink credentials	the active profile's credential link is missing while its stored credentials are intact
install plugin	guidance only: the two /plugin commands to copy