Argon-Sky/herdr-codexbar

An add-on for Herdr that shows, under each agent in the sidebar, which subscription it is using and how much quota is left. It works with 12 coding agents and 8 subscriptions, and reads the numbers from CodexBar, so it never needs your credentials.
Why this one
- **It never touches your credentials.** CodexBar already signs in to your providers and reads their quota. herdr-codexbar only asks the CodexBar CLI for the numbers, so there are no tokens, cookies or API keys to hand over.
- **Quota follows the subscription, not the agent.** Each pane shows the quota of the provider it is talking to right now. OpenCode switching from OpenCode Go to a Command Code model moves the pane to Command Code's quota.
- **Antigravity's two pools.** Gemini models and third-party models (Claude, GPT) have separate quotas in Antigravity. The pane shows the pool of the model it is using.
- **Pace, not just percent.** Every window says whether you are ahead of an even burn (■ in reserve), on pace (◪) or behind (□ in deficit), and when it resets.
- **A setup you can review and undo.** setup --dry-run shows the exact diff, every edited file is backed up, and uninstall puts things back.
Coverage
| Subscription → Harness ↓ | Claude Pro | ChatGPT Plus | SuperGrok | Google AI Pro | OpenCode Go | Command Code GOAT | Copilot Pro | Qwen Cloud Token Plan |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Claude Code | ✅ | ❌ | ❌ | ❌ | ❔ | ❔ | ❌ | ❔ |
| Codex | ❌ | ✅ | ❔ | ❌ | ❔ | ❔ | ❌ | ❔ |
| Grok Build | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Antigravity CLI | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
| OpenCode | ⚠️ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ❔ | ✅ |
| Command Code | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ |
| GitHub Copilot CLI | ❌ | ❌ | ❔ | ❌ | ❔ | ❔ | ✅ | ❌ |
| Pi | ⚠️ | ✅ | ✅ | ⚠️ | ✅ | ❔ | ✅ | ✅ |
| Oh My Pi | ⚠️ | ✅ | ✅ | ⚠️ | ✅ | ❔ | ✅ | ✅ |
| Prime Agent | ⚠️ | ✅ | ✅ | ⚠️ | ✅ | ❔ | ✅ | ❔ |
| Kilo CLI | ⚠️ | ✅ | ✅ | ⚠️ | ✅ | ❔ | ❔ | ✅ |
| Qwen Code | ❌ | ❌ | ❌ | ❌ | ❔ | ❔ | ❌ | ✅ |
- ✅ Integrated in herdr-codexbar and tested
- ❔ Not verified
- ❌ Not possible, as far as we know
- ⚠️ Technically possible, but against the provider's terms; not supported
Notes:
- Codex setup follows CODEX_HOME (default ~/.codex). Standalone sessions use --no-daemon. Agent Identity Launcher remote sessions use a terminal connection that reports each pane's session while keeping the shared server available to ChatGPT.
- Claude Code and Codex reach only some OpenCode Go models: MiniMax and Qwen in Claude Code, GPT Luna, Grok and Muse Spark in Codex. Translating proxies such as LiteLLM are not supported.
- X Premium+ works like SuperGrok, and higher tiers (Claude Max, ChatGPT Pro and similar) like the plans above.
- Qwen Cloud Token Plan is the Qwen Cloud plan, not Alibaba Cloud Model Studio's Coding Plan. CodexBar calls its provider Qwen Cloud. Sign in with /connect → Alibaba Token Plan in OpenCode and Kilo CLI, /login → Qwen Token Plan in Pi, and /login → QwenCloud Token Plan in Oh My Pi.
Requirements
- macOS 14 or newer.
- Herdr 0.9.1 or newer: brew install herdr. Install Herdr's integration for each agent you use, for example herdr integration install claude.
- CodexBar: brew install --cask codexbar. Open it once, sign in to your providers and turn on the ones you want in its settings. The CodexBar CLI (Preferences → Advanced → Install CLI) is optional: herdr-codexbar falls back to the CLI inside the app.
- Fira Code 6 or newer as your terminal font, for the progress bars: brew install --cask font-fira-code. Any Nerd Font 3 or newer works too.