AI quota and sessions
NOBLE reads usage from the logins that the official CLIs already keep on your machine. There is nothing to sign in to and nothing to configure: if you use the CLI, its quota shows up on Home.
Providers
| Provider | Shown | Source |
|---|---|---|
| Claude Code | 5-hour and weekly limits, plan | ~/.claude/.credentials.json → Anthropic OAuth usage endpoint |
| Codex / ChatGPT | 5-hour and weekly limits, plan | ~/.codex/auth.json + codex app-server (account/rateLimits/read) |
| Antigravity | 5-hour and weekly limits (the fuller pool) | agy --print /usage --output-format json; only runs when an agy login exists |
| OpenCode Go | 5-hour, weekly and monthly limits | ~/.local/share/opencode/auth.json → opencode.ai/zen/go/v1/usage |
| Kilo Code | Kilo Pass credits this billing period | ~/.local/share/kilo/auth.json → api.kilo.ai kiloPass.getState |
| Command Code | 5-hour and weekly limits, plan | ~/.commandcode/auth.json → api.commandcode.ai/alpha/billing/credits |
Only providers you are signed in to, and that have a quota plan, are shown.
Your tokens
- Tokens are sent only to their own provider. They are never displayed and never logged.
- NOBLE never refreshes a token, so it cannot race the CLI’s own token rotation.
- The last good numbers are cached and shown with
~until the next successful fetch. A network error never breaks the screen.
When NOBLE fetches
Quotas are fetched only while the Home screen is open: right away when you come back to it and then every refresh_minutes (5 by default). While you work in a terminal NOBLE makes no network calls.
It also watches your pace: when the 5-hour window would fill up before it resets, Home shows a line like ▲ 5h full in ~48m at this pace. And it warns once when a window reaches warn_at percent (90 by default, 0 turns it off).
Claude Code session status (optional hooks)
Without help NOBLE can only guess whether a Claude session is busy. Turn on Settings → AI usage → Claude Code status hooks and NOBLE adds a few hooks to ~/.claude/settings.json. A backup is written next to it, and turning the setting off removes exactly those entries.
Claude then runs noble hook <event> on prompt, stop, notification, session start and session end. The command writes one small file per pane into NOBLE’s data folder and exits; outside NOBLE it does nothing. Home then lists every Claude session:
| Mark | State | Meaning |
|---|---|---|
| ● | working | Claude is busy on a prompt |
| ◆ | needs you | Claude is asking for permission |
| ○ | your turn | Claude finished and waits for your next prompt |