Herdr Claude Usage Multi — Development skill for Claude Code

herdr-claude-usage-multi

Claude plan usage gauges in the [Herdr](https://herdr.dev) spaces sidebar - multi-account aware.

Every workspace row shows how much of the Claude subscription its panes are burning:

● my-project
  main  ✚2
  ■■■■■□□□□□ 51/17

• Gauge = 5-hour session window, numbers = session/week utilization in percent.
• The exact percentages Claude Code shows in /status - no estimation, no extra login, zero plan tokens spent.
• Row color escalates as usage grows: default green, yellow at 70%, red at 90% (worse of the two windows).
• An exhausted window (100%) turns the row into a countdown until usage unblocks:

⏳ back in 47m · 20:50

The countdown targets the latest reset among exhausted windows (a fresh session does not help while the week window is still spent) and ticks with minute precision - computed locally, no extra API calls.

• prefix+u (optional keybinding below) opens a detail popup: big meters, both windows, reset times, all accounts.

Multi-account

If you run several Claude Code profiles (one `CLAUDE_CONFIG_DIR` per folder - work and personal, for example), each workspace shows the account its panes actually run, mapped by pane cwd. Workspaces mixing both accounts get the majority account. With a single default account there is nothing to configure.

Install

herdr plugin install iamhouser/herdr-claude-usage-multi

Add the gauge rows to `~/.config/herdr/config.toml` (the plugin reports exactly one of the four token variants per space; rows without a token are skipped, so regular spaces stay compact):

[ui.sidebar.spaces]
rows = [
  ["state_icon", "workspace"],
  ["branch", "git_status"],
  [{ token = "$cu", fg = "#a6e3a1" }],
  [{ token = "$cu_warn", fg = "#f9e2af" }],
  [{ token = "$cu_hot", fg = "#f38ba8", bold = true }],
  [{ token = "$cu_out", fg = "#f38ba8", bold = true }],
]

Optional popup keybinding:

[[keys.command]]
key = "prefix+u"
type = "shell"
command = '"$