Built on the shoulders of Omarchy. AgentDeck's 23 usage
collectors come straight from the agent-usage tooling in Omarchy (MIT, by David Heinemeier Hansson and
the Omarchy contributors), at tag v4.5.0. Their careful work on quota endpoints, billing attribution
across harnesses, caching and de-duplication is what makes this app accurate. AgentDeck brings that work
to macOS as a native app. Huge thanks to everyone behind Omarchy.
AgentDeck is a native SwiftUI menu bar app and agentdeck CLI for Apple silicon Macs on macOS 14+. It shows how much of each
agent's quota you have used, when it resets, what prepaid balances remain, and what you did locally —
and it lets you keep several Claude Code, Codex and Grok sign-ins side by side, switching manually or
automatically before you hit a limit.
Highlights
- 23 providers, one glance. Claude Code, Codex, Grok, Cursor, GitHub Copilot, Antigravity, Kimi,
DeepSeek, OpenRouter, Fireworks and more. Limits, balances and local statistics are kept distinct — a
limit the provider does not report is never invented.
- Multiple accounts that don't step on each other. Each extra Claude Code / Codex / Grok account gets
its own home and Keychain namespace. MCP servers, hooks, plugins, skills and history are shared with
your primary setup; credentials never are.
- Switch before you stall. Manual switching, or automatic switching at a threshold (default 95%,
50–100%) ranked by headroom and reset time. Only new sessions change account — running ones keep theirs.
- Your existing tools, untouched. Uses the CLIs you already installed (mise first). No agent CLI is
installed or duplicated; existing logins, MCP config, hooks, settings, conversations and databases stay
where they are.
- Self-contained. The
.app carries its own Python and ripgrep for the collectors — nothing else to
install.
- Private by default. Usage stays on the Mac. Optional cross-device aggregation exports usage numbers
only — never sign-ins, account details or conversations.
Screenshots
| Accounts and automatic switching | Prepaid balance (estimate clearly marked) |
|---|
| |
All screenshots use the app's built-in synthetic demo mode (--demo); no real account data is shown.
Install
Apple silicon only. AgentDeck requires a Mac with Apple silicon (M1 or later) and macOS 14 or later.
Intel Macs are not supported.
brew install --cask jdk1021/tap/agentdeck
Or manually:
- Download
AgentDeck-<version>-macos-arm64.dmg (or .zip) from
Releases. Check it against the .sha256 file.
- Drag AgentDeck to Applications.
- The app is ad-hoc signed and not notarized (no Apple Developer ID was available). On first launch
macOS will refuse to open it: open System Settings → Privacy & Security and click Open Anyway
for AgentDeck (or Control-click the app → Open). Do not disable Gatekeeper globally.
- Optional CLI (Homebrew links it for you):
ln -s /Applications/AgentDeck.app/Contents/MacOS/agentdeck ~/.local/bin/agentdeck
Build from source: see docs/installation.md. How releases, upstream updates and
dependency updates are automated: docs/automation.md.
Quick start
agentdeck refresh # collect usage for every provider on this Mac
agentdeck status # one line per provider
agentdeck account add claude Work
agentdeck account login claude <id> # opens the provider's own sign-in in that account's home
agentdeck account use claude <id|next> # new sessions use it; running ones are untouched
agentdeck account mode claude auto 95 # automatic switching at 95%
agentdeck run claude -- --continue # launch with the selected account
agentdeck shell install --shell bash # optional: claude/codex/grok follow the selection
# --shell zsh (default) and --shell fish are also supported
Run agentdeck help for every command.
Providers
| Kind | Providers |
|---|
| Limits + multiple accounts | Claude Code, Codex, Grok |
| Limits | Cursor, Grok Bot, GitHub Copilot*, Antigravity, Kimi, Devin, Z.ai, MiniMax, Qwen Code, Mistral Vibe, Ollama Cloud, Synthetic, Kimchi, Muse |
| Balances | DeepSeek*, OpenRouter, Fireworks*, and balance-based plans of the above |
| Local statistics | Hermes, OpenCode, Local models, and every provider above |
* can show a locally derived estimate, always labelled as such. Full per-provider detail, data
sources and verification status: docs/support-matrix.md.
How it works
A Swift core runs the upstream Python collectors (bundled interpreter, bounded concurrency, timeouts,
process-group cleanup), keeps the last good measurement when a refresh fails, and applies the switching
policy. The SwiftUI app and the CLI share that core. Details: architecture,
account isolation, upstream analysis.
Status
This is the first public release. Read docs/validation.md for exactly what was
verified on real hardware and accounts and what was not, and docs/known-limits.md
before relying on automatic switching.
Uninstall
agentdeck uninstall removes the zsh block; turn off Launch at login, quit, and delete the app. Your
agent logins, settings, histories and AgentDeck's own state are kept — see
docs/installation.md for optional cleanup and restore.
License
MIT — see LICENSE. The collectors remain under Omarchy's MIT license and copyright notice;
bundled CPython, ripgrep and provider icons are listed in THIRD_PARTY_NOTICES.md.
Product names and logos belong to their owners; AgentDeck is not affiliated with any provider.
