Token Usage Monitor

A lightweight macOS menu bar app that tracks your API usage across Claude, Codex (ChatGPT), and GitHub Copilot — all in one place.

Features

• Menu Bar Icon — Custom-rendered progress bars for each service, visible at a glance
• Claude Usage — 5-hour and 7-day windows, Opus/Sonnet breakdowns, extra usage credits
• Codex Usage — Primary and secondary rate limits, code review quotas
• GitHub Copilot — Premium request tracking with unlimited plan support
• macOS Widget — Home Screen / Notification Center widget via WidgetKit
• Auto-Refresh — Polls usage data every 5 minutes (configurable)
• Secure Credentials — Reads existing CLI credentials from Keychain and local config files; nothing leaves your Mac
• Launch at Login — Optional auto-start via ServiceManagement
• Demo Mode — Preview the UI with sample data

Screenshots

Menu Bar	Detail Panel	Widget

Requirements

• macOS 14.5+
• Xcode 15+ (to build from source)

Getting Started

Prerequisites

Sign in to at least one service via its CLI tool:

# Claude
claude login

# Codex (ChatGPT)
codex login

# GitHub Copilot
gh auth login

The app reads credentials from these local files and the macOS Keychain. No API keys need to be entered manually.

Import Credentials (Sandboxed)

For Codex and Copilot, the app may prompt you to import credential files via a file picker:

• Codex: ~/.codex/auth.json
• Copilot: ~/.config/gh/hosts.yml

These are copied into the app's sandboxed container. Claude credentials are read from the Keychain automatically.

How It Works

1. On launch, the app checks for existing CLI credentials (Keychain for Claude, local files for Codex/Copilot).
2. It fetches usage data directly from each service's API:
   • api.anthropic.com — Claude usage
   • chatgpt.com — Codex usage
   • api.github.com — Copilot usage
3. The menu bar icon renders real-time progress bars per service.
4. Usage data is synced to the widget extension via a shared App Group container.

Privacy

No data is collected, stored, or transmitted to the developer or any third party.

• All credentials stay on your Mac (Keychain + sandboxed container).
• API requests go directly to each service using your existing credentials.
• No analytics, telemetry, or crash reports.

See PRIVACY_POLICY.md for full details.

Issues & Feedback

Please report bugs and feature requests on the Issue Tracker.

License

All rights reserved. This software is provided as-is for personal use.

Author

HongKee Moon