A native menu bar app for macOS

The Agentic Apple

Every AI agent's limits, one glance away in your menu bar.

Install View on GitHub

Illustration with invented numbers. The meters are coloured by each window's own state; the marks never are.

Screenshots

The Agentic Apple's status item in the macOS menu bar: five agent marks, each followed by its stacked limit meters.
The status item: one mark and a meter per limit window.
The Agentic Apple panel: per-window percentages, reset countdowns, show switches and drag handles for each agent.
The panel: every window, its reset, and a switch to show or hide each agent.

Install

You need macOS 14 Sonoma or later. Download the disk image, or build it from source.

Download

Download the DMG

Open the disk image and drag The Agentic Apple onto Applications. On its first launch from there it turns on Launch at Login, so it comes back after every restart; switch that off from its menu or Settings if you prefer.

Build from source

With SwiftPM and the Command Line Tools; Xcode is not required.

Terminal
git clone https://github.com/crueber/the-agentic-apple.git \
  && cd the-agentic-apple && scripts/install.sh

The script builds the app, installs it to ~/Applications, links the agentic-apple command into ~/.local/bin and opens it (which turns on Launch at Login, as above). No Command Line Tools yet?

Terminal
xcode-select --install

From version 0.2.0 an installed copy updates itself from the signed GitHub releases; version 0.1.0 has no updater, so install 0.2.0 by hand once. A checkout can also be updated with git pull && scripts/install.sh. To remove the app, its settings and its cache, run scripts/uninstall.sh.

Quietly thorough

Small enough for a notched menu bar. Detailed enough to plan the afternoon around.

  • Five agents

    OpenRouter, OpenCode, Grok, Codex and Claude, each with its own monochrome mark and one meter per limit window: session, weekly, monthly, model-scoped allowances and key limits.

  • Automatic detection

    Agents you have no plan, key or usage for stay out of the bar. Nothing to configure; install a new agent and it appears on the next refresh.

  • Colour thresholds

    A meter turns amber at 70% and red at 90%, or when the provider says you are limited. Both thresholds are adjustable.

  • Drag to reorder

    Drag agents in the panel to set the bar's order, and flip a switch to show or hide one. New agents join at the end.

  • Launch at login

    One switch in Settings, through macOS's own login items. Refreshes every five minutes, backing off politely when a source fails.

  • Privacy-first

    Credentials are read, never refreshed or stored, and the app itself talks only to OpenRouter, Anthropic and GitHub's release pages. How it works

  • Scriptable

    The same readings in your terminal, for scripts and status lines:

    agentic-apple --text agentic-apple --json

  • Signed automatic updates

    New releases install themselves from GitHub, but only when the disk image's Ed25519 signature matches a key built into the app and the app inside is a newer version of itself. A failed install rolls back to the old copy. One switch turns background checks off; Check for Updates… is always in the menu.

How it reads each agent

Each agent is read from the source that agent already keeps. No accounts, no proxies, no extra sign-in.

AgentWhere the numbers come fromWindows
OpenRouter Your key from OPENROUTER_API_KEY or OpenCode's credentials; the app asks OpenRouter's /api/v1/key and /api/v1/credits. Key limit, credits, previous cycle
OpenCode Asks the installed opencode CLI for its usage limits. 5-hour, weekly, monthly, Console budgets
Grok Grok's local billing snapshot in ~/.grok, plus Grok Bot's local cache. Weekly or monthly, Grok Bot weekly
Codex Asks the installed codex CLI for its plan's rate limits. Session, weekly, code review
Claude Claude Code's sign-in, read from the Keychain; the app asks Anthropic's usage endpoint. Session (5-hour), weekly (7-day), model weekly

Grok support is ported from the Omarchy plugin and tested against fixtures only.

Privacy

Your keys and tokens are yours. The Agentic Apple looks, and leaves them exactly as it found them.

Read-only credentials
Keys and tokens are read, never written, refreshed or cached. When Claude Code's sign-in has expired, the panel says Sign-in expired and suggests claude auth login, rather than renewing it behind your back.
Three destinations, no telemetry
The app itself contacts only OpenRouter's key and credits endpoints, Anthropic's usage endpoint, and GitHub to check for and download its own releases. The opencode and codex CLIs it asks talk to their own services, as they always do. No analytics, no accounts; it is MIT-licensed open source, so you can check.
Signed updates
About two minutes after launch and then every six hours, the app asks GitHub for its latest release. An update is installed only if its disk image carries an Ed25519 signature from a key compiled into the app, and the app inside is a newer version of this same app. The check sends no key, token or identifier. Switch off Install updates automatically to stop background checks; Check for Updates… still works.
A local cache
The last readings live in ~/Library/Caches/com.crueber.agentic-apple, in a folder only you can read, so the bar paints instantly at login.

The Agentic Apple is the macOS port of Agent Meters for Omarchy: same agents, same rules, written natively in Swift.