Skip to content
robertlevonyanPublic

About

This is an Open Source utility to show your AI usage limits

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

AI Limits icon

AI Limits

Your Claude Code, ChatGPT Codex and Gemini usage limits at a glance, as macOS widgets in the style of Batteries and a menu bar indicator.

Download the latest release


Widgets

Features

  • Batteries-style widgets. Small, medium and large widgets show how much of each limit is left, with a ring per tool.
  • One widget per AI. Small widgets for Claude Code, Codex and Gemini on their own. The Claude widget also shows a weekly bar.
  • Menu bar indicator. Pick one tool to show its percentage next to the icon. Click it for every limit and its reset time.
  • When it comes back. Shows a countdown to each reset, or the exact time once a limit is used up.
  • Honest numbers. Rings turn orange at 25% left and red at 10%. Numbers from a failed refresh are marked Not updating rather than shown as current.
  • Fast refresh. As often as every 5 seconds. Each service is still asked no more often than it allows.
  • No extra logins. Reads the logins your tools already have: Claude Code, the Codex CLI, and Antigravity or the Gemini CLI.

Per-AI widgets

Menu bar indicator and popover

The images above are rendered from the app's layouts with sample data.

Install

  1. Download AI-Limits-<version>.dmg from Releases.
  2. Open it and drag AI Limits into Applications.
  3. The first time, right-click › Open the app. Current builds aren't notarized yet. If macOS says the app is damaged, run:
    xattr -dr com.apple.quarantine "/Applications/AI Limits.app"
  4. Right-click the desktop › Edit Widgets › AI Limits, and add the widgets you like.

Requires macOS 14 Sonoma or later.

Updates

AI Limits checks this repo's Releases at launch and every 6 hours. When there's a newer version it asks whether to install it. Install Update downloads the DMG, replaces the app and relaunches it. You can also choose Later or Skip This Version. To check by hand, use Settings › Updates › Check Now or AI Limits › Check for Updates….

The app's version comes from the release tag (v1.2.0 → 1.2.0). Builds run from Xcode never replace themselves; they open the release page instead.

Where the numbers come from

Tool Default source Other options in Settings
Claude Code Your Claude Code login (Keychain item Claude Code-credentials). The app renews it when it expires and saves it back, so Claude Code stays signed in. claude.ai browser session (sessionKey cookie), or a pasted OAuth token
ChatGPT Codex ~/.codex/auth.json from codex login. Falls back to the limits in your latest Codex session log. Session logs only (offline), or a pasted access token
Gemini The running Antigravity app (its own live quota). Falls back to Antigravity's saved login, then the Gemini CLI (~/.gemini/oauth_creds.json). Antigravity only, Gemini CLI only, or a pasted Google token

The first time it reads the Claude Code login, macOS asks for permission. Choose Always Allow.

These are the same endpoints the official tools use. They aren't public APIs and may change without notice.

Settings

Click the gauge in the menu bar and choose Settings…, or click the app's Dock icon.

  • Show in menu bar. Icon only, or a tool's percentage left.
  • Percentages show. What's left (Batteries style) or what's used (like Claude's /usage).
  • Refresh every. From 5 seconds to 30 minutes.
  • Show icon in Dock and Launch at login.
  • Per tool. Turn it on or off, pick its source, and see a status line with what the last refresh returned.
  • Run diagnostics. Saves a report to ~/Library/Application Support/AI Limits/diagnostics.txt and copies it to the clipboard. It contains raw usage responses and yes/no checks, never tokens.

Pasted tokens and cookies are kept in your login Keychain.

Build from source

  1. Open AILimits.xcodeproj in Xcode 26 or later.
  2. Under Signing & Capabilities, set your team for both targets. Both use the App Group $(TeamIdentifierPrefix)com.robertlevonyan.ailimits.
  3. Run the AILimits scheme (⌘R).

The project uses folder-synced groups, so files you add to App/, Widget/ or Shared/ are picked up automatically. Debug builds go to a .noindex folder, so they don't show up in Launchpad or the Apps list. After each Debug build, the scheme makes the desktop widgets come from that build and quits an installed copy, so only one AI Limits runs. Open the installed app again to go back to it.

App/      Menu bar app: settings, refresh service, fetchers (Claude, Codex, Gemini/Antigravity)
Widget/   WidgetKit extension: combined widget (S/M/L) and per-AI widgets (S)
Shared/   Models, App Group store, ring and bar views, logos
Config/   Info.plists and entitlements
scripts/  make-dmg.sh

If a widget looks stale after a rebuild, remove it from the desktop and add it again, or run killall chronod NotificationCenter.

Releases

Releases are built by GitHub Actions (.github/workflows/release.yml) on a macOS runner:

git tag v1.0.0
git push origin v1.0.0

A few minutes later, AI-Limits-1.0.0.dmg shows up under Releases. You can also run it by hand from Actions › Release › Run workflow.

Signing is set by repository secrets, listed at the top of the workflow file. The workflow uses Developer ID (signed and notarized) if those secrets are set. Otherwise it uses your team's Apple Development certificate, which works with a free account and is enough for the widgets to get their data. With no secrets the build is unsigned, and on recent macOS its widgets can't read the app's data.

Privacy

Everything runs on your Mac. The app talks only to the services it measures (Anthropic, OpenAI and Google) and to Antigravity on localhost. It has no analytics or tracking.

Disclaimer

AI Limits is an independent project, not affiliated with or endorsed by Anthropic, OpenAI or Google. Claude, ChatGPT, Codex, Gemini and Antigravity are trademarks of their respective owners.

About

This is an Open Source utility to show your AI usage limits

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages