Important
This mod moved to Lakris2407/herdr-mods. This repo is archived; new versions only ship there.
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.
Optional second mod: live CPU, RAM and GPU load beside it, so you do not need Activity Monitor to see what your agents do to your Mac. See System load.
- 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": { "weight": 3.6 }, "min": 130 } ] }Weights, not fixed pixels: on a narrow window every status block keeps a share, and the quota draws shorter bars without window labels, then percents only, so every provider stays visible.
-
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, names and remaining (default false).
Enable Show remaining instead of used in the popup to switch the percentages and bar fills in both views. Colors and pace warnings still reflect usage, so nearly exhausted limits stay red. Used-share windows stay labeled as used because they are not independent allowances.
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). Both commands run on the selected space's machine. The mod itself makes no
network requests and stores no tokens; quota-axi reads that machine's Claude, Codex and other
CLI sign-ins to ask each provider for your usage.
The status bar follows the selected space's machine. Install quota-axi on each remote machine
(npm install -g quota-axi) and sign into your providers there. Credentials stay on that machine.
The popup identifies the machine and stays on it until closed, including when you click Refresh.
Results and errors are cached separately per machine. Switching machines fetches immediately;
an unreachable remote or missing dependency shows an error instead of using your local account.
Options are shared across machines. Sessions using a custom CODEX_HOME are not detected:
the report uses the CLI environment of the machine's Herdr core.
mods/system shows CPU, memory and GPU load next to the quota: a small live graph of the last
36 seconds and the percent for each, in the same green, amber, orange and red scale. Hover for
details (user and system CPU, GB of memory used); click to open Activity Monitor. macOS only.
It reads iostat, vm_stat, sysctl and ioreg every 3 seconds; none need root. Memory is
Activity Monitor's "Memory Used" (app memory, wired and compressed).
Install: copy mods/system to ~/.config/herdr-app/mods/system and add a block before
status-quota in the status row:
{ "id": "status-system", "type": "block", "content": { "mod": "system" }, "size": { "weight": 3.3 }, "min": 120 }On a narrow status bar it drops the graphs, then the GPU, so CPU and RAM always show.
The provider list includes an Antigravity: Claude/GPT limits option.
Turn it off to hide its Claude/GPT session and weekly windows in the strip and popup
without hiding Gemini. This does not affect the standalone Claude provider.
The choice is saved; it defaults to enabled so existing installations keep their display.
Layouts may also set agyClaudeGpt: false in quota props as the initial preference.
- 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
Install Node.js and quota-axi (npm install -g quota-axi) and ensure the npm global
bin directory is on the environment PATH available to Herdr. If the native executable
cannot start, the quota mod tries the Windows npm shim through cmd.exe /d /s /c.
No Git Bash or hard-coded Node installation path is required.
Run quota-axi --json in a terminal to check your provider sign-ins. Then run
herdr-app check ~/.config/herdr-app/mods/quota. The optional system-load mod
remains macOS-only.

