How sakthimpr/claude-codex-tracker works
Claude & Codex Tracker is a macOS menu-bar usage monitor. Its main workflow obtains authenticated usage from Claude and Codex, converts it into a shared snapshot, and displays limits, reset countdowns, and warnings in the native menu. An optional mobile branch pushes snapshots to Supabase for a static web view. The README documents the shared-file handoff and mobile flow; sampled source confirms the Python fetcher’s API requests and Supabase push. The web page’s read implementation was not sampled, so its Supabase read link is based on README documentation.
Main entry points: tracker_data.py Usage fetcher · Launcher.swift Menu-bar interface · index.html Mobile usage page
Components 10
Usage collection
- Usage fetcher
src/python/tracker_data.py - Shared snapshot
Mac app
- Menu-bar interface
src/native/Launcher.swift
Mobile access
- Supabase snapshot
- Mobile usage page
web/index.html
Other components
- User
- Chrome session
- Claude usage API
- ChatGPT session and usage APIs
- Web browser
Connections 11
- Usage fetcher → Chrome session: reads cookies
src/python/tracker_data.py - Usage fetcher → Claude usage API: fetches usage
src/python/tracker_data.py - Usage fetcher → ChatGPT session and usage APIs: fetches usage
src/python/tracker_data.py - Usage fetcher → Shared snapshot: writes snapshot
README.md - Menu-bar interface → Shared snapshot: reads snapshot
README.md - Menu-bar interface → Usage fetcher: starts and refreshes
README.md - User → Menu-bar interface: views and controls
README.md - Usage fetcher → Supabase snapshot: pushes snapshot
src/python/tracker_data.py - Mobile usage page → Supabase snapshot: reads snapshot
README.md - Web browser → Mobile usage page: opens page
README.md - User → Web browser: opens mobile view
README.md