Skip to content

Repository files navigation

Usage Menubar

image

A macOS menubar app that tracks your Claude and Codex usage in real time. See remaining quotas at a glance without leaving your editor.

Download

Download for macOS (Apple Silicon)

Signed and notarized. Open the DMG, drag to Applications, done.

Features

  • Menubar display — remaining percentages (C 81% O 97%) always visible in the macOS menu bar
  • Display mode toggle — switch between "Weekly" and "Session" values in the menubar
  • Claude tracking — current session, all models, and Sonnet-only usage with reset timers (direct API)
  • Codex tracking — 5-hour and weekly limits, per-model breakdowns
  • Chrome cookie import — automatically imports your Chrome login session when possible
  • Provider login flows — Claude and Codex open Chrome for login, then reuse the Chrome session
  • Auto-refresh — updates every 10 minutes in the background

Getting Started

  1. Log in to Claude and Codex in Chrome when prompted
  2. Launch the app — Chrome cookies are imported automatically when possible and data appears
  3. Your session persists across restarts

Tip: If data doesn't show up, click the Refresh button in the popup. Press Login to open the provider in Chrome.

Development

git clone https://github.com/iritec/usage-menubar.git
cd usage-menubar
pnpm install
pnpm dev

Build

pnpm dist      # macOS distributable .dmg / .zip

Built with KingCoding

This app was built with KingCoding — an AI-powered coding assistant that lets you ship real apps fast.

License

MIT

About

macOS menubar app for Claude and Codex usage tracking

Resources

Stars

18 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages