TermTracker

Your $20/mo Claude subscription is worth $12,000+ at API prices.
This shows you that — and everything else your AI tools are doing.

    

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. Multi-Tool Dashboard 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_URL
• TERMTRACKER_CLAUDE_USAGE_URL
• TERMTRACKER_CLAUDE_CLIENT_ID
• TERMTRACKER_CLAUDE_SCOPE
• TERMTRACKER_CODEX_OAUTH_TOKEN_URL
• TERMTRACKER_CODEX_USAGE_URL
• TERMTRACKER_CODEX_CLIENT_ID
• TERMTRACKER_ANTHROPIC_BETA
• TERMTRACKER_USER_AGENT
• TERMTRACKER_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.

_{MIT License}