Show Claude/Codex subscription usage in the spaces sidebar

[ZaynJarvis]

idea / problem

I keep a Claude and a Codex subscription open while I work, and the number I check most often isn't actually in herdr — it's “how much of my 5-hour and weekly limit is left.” Today I run a separate script for that and glance at another window. Since herdr is already where I watch my agents, I'd love it to just show this.

requested change

Show a compact line in the bottom-left of the spaces sidebar, next to the collapse toggle:

CC 2%/56% · CX 6%/42% — 5h% / weekly%, per provider

I put together a small prototype on my fork to feel out whether it's useful in the corner of the screen: https://github.com/ZaynJarvis/herdr/tree/feat/sidebar-agent-usage

It polls each provider's usage endpoint every 60s through herdr's existing curl-subprocess path (no new HTTP/TLS crate), and overlays the existing bottom row so sidebar geometry and mouse hit-testing don't change. It only reads percentages; no token is logged. The branch is reference only — I'm happy to throw it away or rebuild it however fits herdr.

I'd also like your read on where this should live. My prototype bakes Claude/Codex-specific polling into the app because plugins cannot draw sidebar chrome today. A cleaner version might be an extension/API point where an external source pushes a short status string into a server-owned slot and herdr renders it. That would avoid hardcoding two vendors and keep the fact on the runtime side rather than making it TUI-only. I don't know whether that is the right boundary or over-engineering for this feature.

why you want this

Herdr is already where I watch my coding agents, so showing their subscription limits there removes a separate script/window and makes it easier to decide when to switch providers or pace work.

The compact line keeps the information glanceable without changing the sidebar layout. I'd like to contribute this if the direction fits herdr. I know about the first-PR gate, so I'm keeping this as a discussion rather than opening a PR unless a maintainer wants to turn it into an accepted issue.

[carlotran4]

I also would benefit from this, I have a similar thing in tmux. Allowing a customizable section would be even better then it just showing sub usage, kind of like a starship prompt or the tmux status bar. That way any provider can be wired in by the end user quite quickly, or any other status they might want to keep track of.