codemeter

A lightweight desktop app that tracks your AI coding tool usage limits. Lives in the system tray and shows your current usage at a glance.

Features

• System tray app with click-to-toggle info window
• Tracks Claude Code, Codex CLI, OpenCode Go and Grok usage limits
• Shows usage percentages with progress bars for each service's rate-limit windows (5-hour, weekly, monthly — whichever the service exposes)
• Displays reset countdowns and exact reset times
• Auto-refreshes every 60 seconds with 5-minute API caching
• Automatic OAuth token refresh for Claude Code and Grok

Runtime prerequisites

• Logged into Claude Code (claude login) and/or Codex CLI (codex --login)

Installation

Download the latest installer for your platform from the releases page.

macOS

The macOS build is unsigned, so the first launch may show a "codemeter is damaged and can't be opened" warning. This is expected for unsigned apps — clear the quarantine flag after moving the app to /Applications:

xattr -dr com.apple.quarantine /Applications/codemeter.app

Then open it normally.

Development prerequisites

• Rust
• Node.js and pnpm
• Logged into one or more of:
  • Claude Code (claude login)
  • Codex CLI (codex --login)
  • OpenCode with an OpenCode Go subscription (opencode auth login → OpenCode Go)
  • Grok (grok login)

Development

pnpm install
pnpm dev

Build

pnpm build

Produces installers in src-tauri/target/release/bundle/.

How it works

Codemeter reads your existing CLI credentials and queries the usage APIs directly:

• Claude Code: Reads OAuth token from macOS Keychain when available, otherwise falls back to ~/.claude/.credentials.json or ~/.claude/credentials.json, then calls the Anthropic usage API
• Codex CLI: Reads access token from ~/.codex/auth.json, calls the OpenAI usage API
• OpenCode Go: Reads the opencode-go API key from ~/.local/share/opencode/auth.json (or $XDG_DATA_HOME/opencode/auth.json), calls https://opencode.ai/zen/go/v1/usage
• Grok: Reads the OIDC session from ~/.grok/auth.json (or $GROK_HOME/auth.json), calls the Grok CLI billing API. Expired sessions are refreshed via auth.x.ai and written back, using the same auth.json.lock advisory lock as the Grok CLI

No separate login required. CLIs that are not installed are hidden; installed-but-logged-out ones show a login hint.

Tech stack

• Tauri v2 (Rust backend)
• React + TypeScript (frontend)
• Vite (bundler)

License

MIT