Repository navigation
AgentMenu 1.0.0
A macOS menu bar app that tells you what your AI coding agents are doing — and when one is waiting on you.
Monitors Claude Code, Codex and opencode across CLI, IDE-extension and app modes: current activity, token totals, cost, context-window fill, and a permission alert when an agent is blocked.
Install
Download AgentMenu-1.0.0.dmg below, open it, drag AgentMenu.app to Applications.
macOS will block the first launch
AgentMenu is ad-hoc signed, not notarised (that needs a paid Apple Developer ID), so you'll see "AgentMenu.app cannot be opened because the developer cannot be verified." This is expected and happens once. Use whichever works on your version:
System Settings (most reliable on macOS 15+) — double-click the app once, dismiss the warning, then go to System Settings → Privacy & Security, scroll to "AgentMenu.app was blocked…" and click Open Anyway.
Right-click (macOS 14, sometimes later) — right-click or Control-click AgentMenu.app → Open → Open. Plain double-clicking will not work, and neither will Launchpad.
Terminal (if neither appears) — xattr -d com.apple.quarantine /Applications/AgentMenu.app
After it opens
There is no Dock icon and no window — that's intentional. Look for the pulse glyph in the menu bar, top right. Click it → Preferences to enable Start at login and install the permission-detection hooks.
Start at login requires the app to live in /Applications — SMAppService registration fails elsewhere.
Requires macOS 14+. Universal binary (Apple Silicon and Intel).
What's honest about it
- Codex permission state is inferred, and shown as such. Codex records no approval events anywhere on disk, so a blocked Codex is a stall heuristic — rendered as a hollow amber ring and "MAYBE WAITING", never the solid red a confirmed block gets.
- No quota percentages. Neither Claude Code nor Codex persists rate-limit state locally, so any "% of your weekly limit" would be invented. You get absolute rolling burn instead, plus an optional budget you set yourself.
- Unknown numbers render as
—, never as$0.00or a meter against a guessed context window.
Touching your agent configs
Permission alerts need hooks in ~/.claude/settings.json and ~/.codex/config.toml. Both are opt-in from Preferences and fully reversible: a timestamped backup is written before any edit, every entry AgentMenu adds is tagged, and the Codex shim forwards to whatever notify program you already had. The installer refuses rather than risks a config it cannot safely round-trip.
Known limitations
- Ad-hoc signed, not notarised (that needs a paid Developer ID).
- Claude's
permission_prompthook subtype is unproven — the idle subtype was verified live and maps correctly. - opencode context meters require the model to be in
pricing.json(deepseek-v4-proandkimi-k3ship). - Codex cost is an estimate; OpenAI's service-tier and long-context multipliers aren't modelled.
- ~180 MB RSS and ~3% CPU while agents are active, most of it a one-time parse of transcript history at launch.
130 tests. Verified end-to-end against live agents.