Skip to content
This repository was archived by the owner on Nov 1, 2026. It is now read-only.
Lakris2407Public archive

About

Agent quota bars (Claude 5-hour + weekly, Codex, more) and live CPU/RAM/GPU load for the Herdr status bar. Herdr mods.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

19 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Important

This mod moved to Lakris2407/herdr-mods. This repo is archived; new versions only ship there.

Agent quota and system load for Herdr

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.

System load and agent quota in the Herdr status bar

Agent quota popup

  • Every limit at a glance: Claude 5-hour and weekly, Codex weekly, and any other provider quota-axi knows (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.

Requirements

  • The Herdr desktop app (herdr-app).

  • quota-axi by kunchenguid, which reads the quota:

    npm install -g quota-axi
    quota-axi            # check that it sees your providers

Install

  1. Copy mods/quota to ~/.config/herdr-app/mods/quota.

  2. 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"}'
  3. 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.

  4. 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".

Options

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.

What it runs

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.

Remote machines

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.

System load (optional second mod)

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.

Antigravity limits

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.

Credits

  • 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.

License

MIT

Windows

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.

About

Agent quota bars (Claude 5-hour + weekly, Codex, more) and live CPU/RAM/GPU load for the Herdr status bar. Herdr mods.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages