diff --git a/apps/token-ledger/README.md b/apps/token-ledger/README.md new file mode 100644 index 0000000..8e5cd05 --- /dev/null +++ b/apps/token-ledger/README.md @@ -0,0 +1,30 @@ +TokenLedger is a native macOS dashboard that answers one question for +everyone who builds with AI coding tools: what did the models actually +cost me today? + +Every CLI assistant keeps its own usage log, in its own format, under +its own directory. TokenLedger reads them all on launch — ZCode's +SQLite ledger, Codex JSONL sessions, DeepSeek Harness workdirs, Claude +Code transcripts — and merges them into a single ledger of tokens, +requests, cache behavior and list-price cost. Any other folder that +matches a known log shape can be added from the Sources page, and any +source can be toggled off without touching a config file. + +The Overview page carries a nine-tile KPI grid — today's tokens, the +trailing week, list-price cost, cache hit, tool calls, failed and +retried shares — over stacked area charts by source, a year of calendar +heat, the last two weeks hour by hour, and where the tokens go. The +Models page breaks the same ledger down per model over 1D, 7D, 30D or +all time: speed in output tokens a second, cache hit, and what the +usage would cost at each model's official card, never a guess for a +model without one. + +It is built on Ely: the KPI tiles, the segmented span control, the data +table on the Models page, and every chart — areas, bars, lines, both +heatmaps — are Ely components in dark and light. + +![Overview](light.png) + +![Models](models.png) + +![Sources](sources.png) diff --git a/apps/token-ledger/light.png b/apps/token-ledger/light.png new file mode 100644 index 0000000..8dd5ce8 Binary files /dev/null and b/apps/token-ledger/light.png differ diff --git a/apps/token-ledger/manifest.json b/apps/token-ledger/manifest.json new file mode 100644 index 0000000..6626173 --- /dev/null +++ b/apps/token-ledger/manifest.json @@ -0,0 +1,20 @@ +{ + "id": "token-ledger", + "name": "TokenLedger", + "author": "nanami-0713", + "description": "One ledger for every model call on the machine: tokens, list-price cost and plan credits, read from the local logs of ZCode, Codex, Claude Code and friends, then drawn in Ely charts.", + "category": "dev", + "platforms": [ + "macOS" + ], + "website": null, + "source": "https://github.com/nanami-0713/token-ledger", + "publishedAt": "2026-10-06T00:00:00+08:00", + "previews": [ + "light.png", + "models.png", + "sources.png" + ], + "stars": 2, + "starsUpdatedAt": "2026-10-09T20:19:25.654Z" +} diff --git a/apps/token-ledger/models.png b/apps/token-ledger/models.png new file mode 100644 index 0000000..de35fb0 Binary files /dev/null and b/apps/token-ledger/models.png differ diff --git a/apps/token-ledger/sources.png b/apps/token-ledger/sources.png new file mode 100644 index 0000000..789132b Binary files /dev/null and b/apps/token-ledger/sources.png differ