burakgon GitHub avatar

ai-usage-menubar

burakgon

AI Usage is a native macOS menu bar app that displays real-time usage limits for Claude Code and Codex without requiring any extra accounts, API keys, or background overhead.

Stars

10

7-day growth

No data

Forks

1

Open issues

0

License

MIT

Last updated

2026-07-28

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It achieves 0.0% CPU usage between scheduled refreshes, reads local OAuth credentials directly from the CLI tools, and uses native Liquid Glass appearance — all while staying completely out of the way.

Who it is for

  • Claude Code power users on macOS
  • Codex users who monitor usage quotas
  • Developers who prefer lightweight, privacy-friendly menu bar utilities
  • Users looking for a minimal-resource alternative to heavy browser-based usage trackers

Use cases

  • Check remaining Claude Code session/weekly limits from the menu bar at a glance
  • Monitor Codex Spark and weekly usage without opening a browser or terminal
  • Quickly toggle between providers (Claude Code, Codex), periods (session/weekly), and display modes (used/left)
  • Set automatic refresh intervals from 1 to 60 minutes and receive one-click update notifications

Strengths

  • Native macOS app with zero CPU usage between refreshes and no Dock icon or persistent window
  • Reads local OAuth credentials; no telemetry, usage history, or external server required
  • Supports multiple limit types (Claude Code session/weekly/Sonnet/Fable, Codex session/weekly/Spark/Spark weekly) with configurable display
  • Open source under MIT license with Sparkle‑based signed updates and a clean SwiftUI interface

Considerations

  • Requires macOS 26 or newer
  • Current builds are ad‑hoc signed; first launch may need manual approval via right‑click → Open
  • Does not support API‑key‑only Codex authentication (cannot read ChatGPT usage)

README quick start

AI Usage

Claude Code and Codex limits, one click away. Native Liquid Glass. Measured at 0.0% CPU between scheduled refreshes.

A real native menu bar popover — no Dock icon or persistent window.

AI Usage shows the limits that matter and stays out of the way. No extra account, API key, local server, telemetry, usage history, or background log scanning.

Other usage apps stay heavy. AI Usage stays light.

Download

Open the DMG, drag AI Usage to Applications, and launch it. It appears in the menu bar rather than the Dock. macOS 26 or newer is required.

[!NOTE] Current public builds are ad-hoc signed because a Developer ID certificate is not available yet. If macOS blocks the first launch, right-click AI Usage in Applications and choose Open. Future updates are still protected by Sparkle's EdDSA signature.

What you get

  • Claude Code session, weekly, Sonnet, and Fable limits
  • Codex session, weekly, Spark, and Spark weekly limits
  • Remaining or used percentages, switchable directly in the panel
  • A selectable provider and session/weekly value directly in the menu bar
  • Configurable 1, 5, 15, 30, or 60-minute refresh and one-click manual refresh
  • Signed update checks at launch and daily, plus Check for Updates…
  • A direct Update button in the panel when a new version is available
  • Provider cards only for installed tools, with signed-out status kept visible
  • Native light and dark appearances with Liquid Glass
  • Launch at Login enabled by default and still user-controllable

Build from source

You need:

  • macOS 26 or newer
  • Xcode 27 or newer
  • Claude Code and/or Codex already signed in locally

Then:

git clone https://github.com/burakgon/ai-usage-menubar.git
cd ai-usage-menubar
./scripts/install.sh

The script builds a local Release version, installs it to ~/Applications/AI Usage.app, and opens it. AI Usage appears in the menu bar, not the Dock.

To run without the installer, open AIUsage.xcodeproj in Xcode and run the AIUsage scheme.

How it works

AI Usage reads the same local OAuth credentials already created by the claude and codex CLIs, then requests quota data directly from the providers' first-party endpoints.

  • Credentials stay on your Mac.
  • Tokens are never printed, logged, or sent anywhere else.
  • Temporary failures keep the last

Description

A tiny native macOS menu bar app for Claude Code and Codex usage limits.

Related repositories

Similar projects matched by category, topics, and programming language.

makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958
Blaizzy
Featured
Blaizzy GitHub avatar

nativ

Nativ is a native macOS app that lets you run AI models locally on Apple silicon, offering chat, model management, performance analytics, and an OpenAI/Anthropic-compatible API server.

AI & Machine LearningAI Vision & Audio
985
uzairansaruzi
Featured
uzairansaruzi GitHub avatar

hermex

Hermex is a native SwiftUI iPhone app that lets you control a self-hosted Hermes AI agent directly from your phone, with no subscriptions, tracking, or third-party relay.

AI & Machine LearningLarge Language Models
941