A macOS menu bar app that indexes your local Claude Code sessions and gives you a clear picture of how you use it — costs, activity, conversations, and knowledge areas.
Recall reads the JSONL files that Claude Code writes to ~/.claude/projects/, parses every message, and stores them in a local SQLite database. From there it surfaces:
- Dashboard — weekly activity chart, token spend, cost vs. billing cycle budget, top projects
- Conversations — full session history with per-message thinking blocks, models used, and tools called
- Knowledge — topic classification of past sessions so you can find what you worked on
- Menu bar popover — quick stats and recent sessions without opening the main window
Pricing is calculated from LiteLLM's public pricing data. If the JSONL already contains a costUSD field (Claude Code ≥ some versions), that value is used directly; otherwise it falls back to the pricing engine estimate.
- macOS 14 Sonoma or later
- Xcode 15+ or Swift 5.9+ toolchain
- Claude Code installed (the app reads
~/.claude/projects/)
swift build -c release
swift runOr open the package in Xcode and run the Recall target.
| Layer | Technology |
|---|---|
| UI | SwiftUI + Swift Charts |
| Database | SQLite via GRDB.swift |
| Pricing | LiteLLM pricing API (fetched at launch) |
| Distribution | Single .app bundle, no installer |
Everything stays local. Recall never sends your conversations or usage data anywhere. The only network request is a one-time fetch of the LiteLLM pricing JSON to keep token costs up to date.