You’re running Claude Code in five terminals, Cursor has six background processes eating 2GB of RAM, Codex is somewhere in the background, and you have zero visibility into any of it.
TermTracker is a native macOS menu bar app. One click and you see everything — live tokens, API cost savings, active sessions, memory usage, running processes — across Claude Code, Cursor, Codex, and Gemini simultaneously.
Usage Dashboard
Quotas, live tokens, cost savings, sparkline
|
Process Monitor
AI tools grouped by terminal with memory and runtime
|
Models & Sessions
14-day trend, model breakdown, active sessions
|
Multi-Tool Tracking
Peak hours, Codex sessions, Cursor completions
|
GitHub PRs
PR overview, health checks, repos with open PRs
|
Highlights
Live Token Tracking
Scans JSONL session files directly — not just the stats cache. See input, output, cache read, cache write breakdown. Real-time tokens/minute sparkline with intensity-based color coding.
API Cost Equivalent
See exactly what you’d pay at API prices. Your Pro plan? Saving you thousands. Max 5x? Tens of thousands. It’s right there in the hero banner.
Process Monitoring
Every AI process on your machine, auto-grouped by terminal. Ghostty, Warp, iTerm2, VS Code, Zed, Alacritty, tmux — detected with native SVG brand logos. Kill processes individually or nuke entire groups.
|
Session Intelligence
Extracts session names, git branches, and working directories from Claude Code JSONL. Shows active sessions with green dots. Timeline visualization of your entire coding day.
14-day trend charts. Model usage breakdown (Opus, Sonnet, Haiku). Peak coding hours heatmap. GitHub PR status with CI, reviews, and merge readiness. Cursor completions. Codex sessions.
Native & Fast
Pure SwiftUI with macOS Tahoe glass effects. Lives in your menu bar. Global hotkey (Cmd+Shift+T). Zero dependencies. All data stays local — nothing leaves your machine.
|
Install
Download the latest release:
TermTracker.dmg — Download, open, drag to Applications.
TermTracker.zip — Alternative manual install package.
First launch should open normally on notarized releases. If macOS warns, delete older downloaded copies (for example TermTracker 2) and install the latest release asset. Grant Accessibility permission when prompted for the global hotkey.
Build from source
git clone https://github.com/isaacaudet/TermTracker.git
cd TermTracker
open TermTracker.xcodeproj
Hit Run. Requires Xcode 26.
Requires macOS 26 (Tahoe). Optional: gh CLI for GitHub PR data.
How it works
TermTracker reads local files and system APIs. Network requests are optional and only used for GitHub PRs (via gh CLI) and provider quota windows (Claude/Codex) when available.
| Data |
Source |
| Token counts & session history |
~/.claude/projects/*/*.jsonl |
| Historical stats & model usage |
~/.claude/stats-cache.json |
| Claude/Codex quota windows (optional) |
Provider usage APIs via local OAuth credentials |
| Codex sessions |
~/.codex/sessions/ |
| Cursor completions |
~/.cursor/ai-tracking/*.db (SQLite) |
| Running AI processes |
sysctl + proc_pidinfo (Darwin) |
| GitHub PRs |
gh api graphql |
Provider API Overrides (Optional)
Quota endpoints and OAuth constants can be overridden at runtime via environment variables:
TERMTRACKER_CLAUDE_OAUTH_TOKEN_URLTERMTRACKER_CLAUDE_USAGE_URLTERMTRACKER_CLAUDE_CLIENT_IDTERMTRACKER_CLAUDE_SCOPETERMTRACKER_CODEX_OAUTH_TOKEN_URLTERMTRACKER_CODEX_USAGE_URLTERMTRACKER_CODEX_CLIENT_IDTERMTRACKER_ANTHROPIC_BETATERMTRACKER_USER_AGENTTERMTRACKER_ALLOW_UNSAFE_ENDPOINT_OVERRIDES (1 to permit non-default hosts)
By default, URL overrides must be https:// and point to official hosts:
- Claude:
platform.claude.com, api.anthropic.com
- Codex:
auth.openai.com, chatgpt.com
Set TERMTRACKER_ALLOW_UNSAFE_ENDPOINT_OVERRIDES=1 only for controlled testing.
Release Security Check
After building Release, run:
scripts/release_security_check.sh
Or point at a specific app:
scripts/release_security_check.sh /path/to/TermTracker.app
The script checks signature identity, entitlements (get-task-allow), Gatekeeper acceptance, and stapled notarization ticket status.
Release QA
- Checklist:
docs/release-checklist.md
- Smoke test script:
scripts/smoke_test.sh
Build DMG Installer
Create a standard drag-to-Applications disk image from a signed app bundle:
scripts/build_dmg.sh /path/to/TermTracker.app
Optional output path:
scripts/build_dmg.sh /path/to/TermTracker.app ./build/TermTracker.dmg
Built with SwiftUI. No Electron. No web views. No telemetry. Just a fast, native Mac app.
Licensed under the MIT License.
评论