AgentLimits

AgentLimits

**In Development**

AgentLimits is a macOS Sonoma+ menu bar app with Notification Center widgets. It shows usage limits for ChatGPT Codex / Claude Code (5-hour + weekly, or monthly when the provider returns a monthly window), GitHub Copilot (monthly premium requests), and ccusage token usage. Custom usage scripts also let you track any other service's usage (e.g. Cursor, Google Antigravity) the same way — see [Custom Usage Script Authoring](#custom-usage-script-authoring).


Download

Download the latest build: [Download](https://github.com/Nihondo/AgentLimits/releases/latest/download/AgentLimits.zip)

Quick Start (First-Time Setup)

1. Run AgentLimits.
2. Add widgets in Notification Center.
3. Open AgentLimits Settings... from the menu bar.
4. In Usage, choose Codex, Claude Code, or Copilot, set refresh interval (1–10 minutes), open the bottom login panel (▲), then sign in.
5. Use the menu bar Display Mode to switch Used/Remaining, and Refresh Now for manual updates.

What It Tracks

• Usage limits (Codex / Claude Code): 5-hour + weekly usage, or monthly usage when the provider returns a monthly window, via internal APIs.
  • If Codex temporarily returns only a weekly window, AgentLimits keeps the 5-hour slot unavailable and displays the returned value in the weekly slot.
  • Codex: https://chatgpt.com/backend-api/wham/usage
  • Claude Code: https://claude.ai/api/organizations/{orgId}/usage
• Usage limits (GitHub Copilot): Monthly premium interaction quota via entitlement API.
  • Copilot: https://github.com/github-copilot/chat/entitlement
• Custom usage services: Run a user-selected executable that prints an AgentLimits JSON snapshot to stdout. Each service may provide one or two unique 5h, 1w, or 1month windows.
• Token usage (ccusage): daily/weekly/monthly tokens and cost via CLI.
  • Codex: npx -y ccusage@latest codex daily
  • Claude Code: `npx -y ccusage@l