/token-receipt

12

Your agent has expenses.

Officially itemized for Codex, Claude Code, and Cursor* local sessions.

Token Receipt turns local agent logs into your coding-agent bill with a thermal-paper PNG, optional share text, and a skill-native flow that works inside the tools people already use.

Skill-first. Local-first.

Install Token Receipt

$ npx skills add ameyalambat128/token-receipt --skill token-receipt

Token Receipt

Officially Itemized

Codex + Claude Code + Cursor*

ORDER #0001 FOR AMEYA

184 SESSIONS FROM MAY 10 TO JUNE 8

GENERATED MONDAY, JUNE 8, 2026

QTYITEMAMT
01Actual useful LLM work$781
02Context window emotional support$2,488
03MCP tool tourism$0.94
++3 more low-signal habits skipped
Sessions:184
Tool calls:612
Tokens burned:1.92M
Longest streak:6 days
TOTAL:$4,208

Avoidable waste:$3,427

Useful work:$781

THANK YOU FOR PROMPTING

Codex and Claude Code support

Both agents get the same skill-first flow. The skill calls the local runtime, reads the structured analysis, and then lets Codex or Claude Code write the final response using the session you are already in, instead of a separate API key.

Quickest

/token-receipt

Or be specific

/token-receipt Generate a receipt for my last 30 days of Codex, Claude Code, Kiro CLI, and Cursor usage.

What is Token Receipt?

Token Receipt is a screenshot-first usage artifact for coding agents.

It reads the session logs that Codex, Claude Code, and Kiro CLI already write locally, plus experimental local Cursor workspace metadata and request traces, turns those into structured usage facts, and lays them out as an itemized bill.

The result feels personal because it reflects your own habits: repeated file reads, subagent sprawl, context bloat, and every other expensive little ritual.

  • Reads local logs from Codex, Claude Code, Kiro CLI, and experimental Cursor local sessions
  • Kiro spend uses local credit usage instead of token pricing
  • Cursor receipts currently prioritize tool activity over exact spend accounting
  • Builds a thermal-paper PNG plus a generic share caption
  • Uses skills so the host agent can write the final roast

Kiro CLI session support

Kiro CLI is supported as a local session source. Token Receipt reads the Kiro SQLite session store, extracts tool activity and local credit usage, and folds that into the same receipt flow as the other supported agents.

Because Kiro does not expose the same local token counters here, the Kiro portion of the bill uses local credit usage instead of a token-derived API estimate.

Experimental Cursor local support

Cursor is supported experimentally from local workspace metadata and request trace logs. That gives Token Receipt enough signal to group Composer activity, count reads and searches, and fold those habits into the same receipt flow.

The tradeoff is accounting fidelity. Cursor does not currently expose the same local token and cost counters here, so the receipt treats Cursor as behavior-rich but spend-light.

Why this exists

The accurate observability product is not the point.

The point is a screenshot people instantly understand: your coding agent bill, officially itemized, with a line item for every bad habit you already know you have.

Real local signals make the output feel specific instead of generic.

What it itemizes

V1 focuses on signals we can defend from the logs:

Context window emotional support
Repeated file reads
Repeated shell confidence loops
MCP tool tourism
Subagent middle management
Planning before touching a file
Cache-heavy sessions
Low-output expensive runs

Every bill is derived from local agent logs.

How it works

Token Receipt is local parsing plus agent-native copywriting, not a new hosted AI layer.

1.

The runtime scans local Codex, Claude Code, and Kiro CLI session logs, plus experimental Cursor local artifacts

2.

Deterministic heuristics turn those logs into receipt facts

3.

The skill asks Codex or Claude Code to phrase the final response using the session you are already paying for

No prompt uploads by default. No telemetry in v1.

Who this is for

  • People shipping with Codex, Claude Code, Kiro CLI, or Cursor every day
  • People who want Kiro CLI credits and tool detours in the same receipt

Open source

MIT licensed and open source.

GitHub repository

FAQ

No for the skill-first path. The local runtime computes the facts, and Codex or Claude Code uses the session you are already in to phrase the roast. The runtime itself does not call OpenAI or Anthropic APIs directly in v1.
V1 supports Codex, Claude Code, Kiro CLI, and experimental local Cursor sessions. Cursor support is behavior-first today, so the receipt can reflect local tool activity even when spend fidelity is lower than Codex or Claude Code.
Cursor support is experimental. Token Receipt reads local Cursor workspace metadata and request traces, so it captures tool activity well, but Cursor does not expose the same local token and cost counters here. That makes the Cursor portion behavior-rich but spend-light compared to Codex and Claude Code.
No. The runtime stays local. Skills are instructed to pass sanitized structured facts into the host agent instead of raw session logs unless you explicitly ask for deeper inspection.
It is grounded in real local usage and tool signals, but it is still an interpretation of local agent activity rather than a billing ledger. Kiro cost is based on local credit usage rather than token-derived API pricing, and experimental Cursor support currently emphasizes behavioral signals over invoice-grade spend accounting.
Each run produces a thermal-paper PNG plus a generic share caption you can edit anywhere. The output feels personal because it is derived from your own agent habits, not from a generic meme generator.
GitHubX