Tokentrail

Here be tokens


() Token step
──── Trail
─┬─ Branch
Merged PR
! Anomaly
Feature complete
Cost Todayof this week
Merged PRs011 total · all time
Anomaliesactive
Sessionstoday

What it does

Three things, kept local

Tokentrail reads what Claude Code already wrote to disk, and turns it into a ledger you can navigate by branch, feature, and PR.

Reads your local logs

Every session's JSONL stays on your machine. Tokentrail reads them in place — never uploaded, never proxied, never seen by anyone but you.

Maps cost to your work

Each token step gets tied to the Git branch you ran it on, the feature it touched, and the PR that merged it.

Surfaces what burns

Spike days, hot sessions, and burning features get flagged automatically. Optional Notion sync mirrors your daily rollup for the team.


Onboarding wizard

A guided checklist on first run

CLI, SwiftBar menubar widget, dashboard daemon, Claude Code skills, session-end hook, and a clickable Tokentrail.app launcher — installed one tick at a time, with the trail map building itself beside you as you go.

Tokentrail welcome wizard: a five-item install checklist on a parchment-themed page, with an ASCII trail map preview rendering on the right.

The wizard reflects live state — every box ticks itself as each piece lands.


Daily dashboard

Where the trail picks up each morning

Cost today, the week so far, sparklines per top feature, and a running list of every commit Tokentrail attributed since you last looked.

Tokentrail overview page: cost sparkline chart, weekly stat block, list of top features with mini-sparklines and percentages, and a recent-commits feed.

Real data from the local SQLite — no demo numbers, no remote calls.



Spot what's burning

Anomalies, surfaced before the bill is

Tokentrail flags spike days, hot sessions, and burning features automatically — pulled together on a single triage view so you don't have to grep your wallet.

Tokentrail anomalies page: a table of detected spending spikes, each row showing the affected feature, the spike amount versus the week's average, and a snooze action.

Each row is a real signal from the local model — snooze, investigate, or jump straight into the feature.


Feature deep-dive

Drill into any feature

Cost over time, a session-level breakdown, and the exact commits that finished the work. Topic clustering groups related sessions when transcripts overlap.

Tokentrail feature detail page for the tokentrail master feature, showing breadcrumb chips, total cost, a trail-elevation cost chart, and a sessions table.

Branch ↔ feature ↔ PR — the same attribution chain, all the way down.


Optional — Notion sync

Tokentrail can mirror your daily rollup into a Notion database — one env var to enable, runs on the same daily cadence as tokentrail rollup. Setup lives in the README under Notion sync.