Your coding agents' usage limits in the Herdr status bar: one slim bar per limit, so Claude's 5-hour and weekly limits show side by side. Quiet until it matters: bars turn amber at 60%, orange at 80% and red at 92%. Click it for details and options.
- Every limit at a glance: Claude 5-hour and weekly, Codex weekly, and any other provider
quota-axiknows (Cursor, GitHub Copilot, Grok, Kimi). - Pace: a thin tick on each bar marks how much of the window has passed. A small ▲ means you are using it faster than the clock.
- Popup: reset times, "ahead of pace" or "under pace", and options for what the bar shows: 5-hour, weekly, monthly and per-model limits, each provider, signed-out providers, names.
- Follows your Herdr theme, light and dark.
-
The Herdr desktop app (
herdr-app). -
quota-axiby kunchenguid, which reads the quota:npm install -g quota-axi quota-axi # check that it sees your providers
-
Copy
mods/quotato~/.config/herdr-app/mods/quota. -
Herdr's own layouts are read-only, so clone one and put the quota block in its status bar. Clone
main(this switches to the clone):herdr-app do layout.clone '{"name":"main","as":"main-plus"}'
-
In
~/.config/herdr-app/layouts/main-plus.json, replace the status block{ "id": "status", "type": "block", "content": { "mod": "workspace-status" }, "size": { "px": 28 } }with a row that holds both:
{ "id": "status", "type": "row", "size": { "px": 28 }, "resizable": false, "children": [ { "id": "status-main", "type": "block", "content": { "mod": "workspace-status" }, "size": { "weight": 1 } }, { "id": "status-quota", "type": "block", "content": { "mod": "quota" }, "size": { "px": 360 } } ] } -
Check it:
herdr-app check ~/.config/herdr-app/mods/quota.
Or ask the agent running in Herdr: "add the herdr.dev mod Lakris2407/herdr-quota".
Click or right-click the bar to choose what it shows; choices are saved. A layout can set the
starting options with props, for example to hide a provider:
"content": { "mod": "quota", "props": { "hidden": ["cursor"] } }props takes hidden (provider ids), kinds ({ "session": true, "weekly": true, "monthly": true, "model": false }),
signedOut and names.
Keys: bind quota:menu (open the popup) and quota:refresh (read now) in keys.json.
The mod runs quota-axi --json every 2 minutes, and when you click Refresh. If Herdr cannot find
it on its own PATH (common when Herdr starts from the Dock), it asks your login shell
($SHELL -lic). The mod itself makes no network requests and stores no tokens; quota-axi reads
your local Claude, Codex and other CLI sign-ins to ask each provider for your usage.
- Quota data: quota-axi by kunchenguid (MIT).
- Provider icons: the ones Herdr ships in
~/.config/herdr-app/icons; this repo includes none. - Built on the Herdr mod API.
MIT
