aqua5230

aqua5230 / usage

Public

Privacy-first macOS menu bar tracker for Claude Code & Codex usage — no provider API calls

claude-code codex macos menubar pyobjc
14
2
89% credibility
Found May 18, 2026 at 40 stars 4x -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

This is a free, open-source tool for Mac users who work with Claude Code or Codex AI assistants. It adds a small indicator to your menu bar showing how much of your usage quota you've used in the current session and this week. When you click it, you see a detailed breakdown with progress bars, countdown timers until your limits reset, and today's spending. The tool reads information directly from files that Claude Code and Codex already create on your computer, so it never makes any calls to external services and won't affect your usage numbers just by running. It can display information in your menu bar or in your terminal, and it starts automatically each time you log in.

How It Works

1
💡 You want to track your AI usage

You've been using Claude Code or Codex and want to know how much of your usage limit you've consumed without constantly checking manually.

2
📥 You download and install the tool

You grab the app from GitHub and set it up on your Mac in just a few steps.

3
🔗 You connect it to your AI assistant

A simple setup command links the tool to your Claude Code, creating a tiny helper that watches your usage in the background.

4
🔋 A little icon appears in your menu bar

Right up in the corner of your screen, a paw print icon shows your current usage percentage at a glance.

5
You can check usage two ways
🖱️
Click the menu bar icon

A beautiful popover shows your session usage, weekly usage, reset timers, and today's spending all in one place.

⌨️
Use the terminal view

A colorful text-based display inside your terminal shows the same information with fun loading animations.

6
⏰ It runs quietly in the background

The tool starts automatically when you log in, keeping your usage numbers up to date without any extra effort from you.

✅ You always know where you stand

No more surprises when you hit limits mid-project. You can plan your work knowing exactly how much AI power you have left.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 40 to 14 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is usage?

Usage is a macOS menu bar widget that displays your Claude Code and Codex usage limits right at the top of your screen. It shows your 5-hour session quota, 7-day weekly quota, and today's estimated cost—all in a clickable popover. Built in Python, it works entirely offline by tapping into data that Claude Code and Codex already write to your local disk, so it never makes API calls and avoids the observer effect of "pinging counts as usage."

Why is it gaining traction?

The privacy angle is the hook: since it reads only local files and makes zero network requests, power users trust it won't accidentally count itself against your limits. Setup is minimal—just `python3 main.py --setup` wires up a statusLine hook, then it runs quietly in your menu bar. You also get a terminal-based UI as an alternative, which developers who live in the terminal appreciate. The ability to see both Claude Code and Codex quotas side-by-side in one glance is genuinely useful for power users juggling both tools.

Who should use this?

Claude Code Pro and Team users who keep hitting rate limits and want to watch their consumption without opening dashboards or checking emails. Developers running both Claude Code and Codex who need a quick glance at where they stand across both. Anyone skeptical of tools that make background API calls and want a completely offline solution.

Verdict

With only 14 stars and a credibility score of 0.8999999761581421%, usage is early-stage and unproven. Documentation exists but is thin, and test coverage isn't visible. That said, the core approach—local-only, no network calls, no Keychain access—is architecturally sound and addresses a real pain point. If you need this functionality today, it's one of the few options available, but watch for a more stable release with clearer versioning before committing to daily driver status.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.