Skip to content

About

Agent quota bars (Claude 5-hour + weekly, Codex, more) for the Herdr status bar. A herdr mod.

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Agent quota 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.

Agent quota

  • 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": { "px": 360 } }
    ] }
  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 and names.

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

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

About

Agent quota bars (Claude 5-hour + weekly, Codex, more) for the Herdr status bar. A herdr mod.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages