AIRECEIPTS

Docs ledger

Share and export

Rendered from docs/guide/11-share-and-export.md.

Share and export

Goal: get a receipt out of the terminal — as an image to share, as data to process, or as a comment on your pull request.

As an image (SVG / PNG)

aireceipts --svg -o receipt.svg          # scalable vector, light theme
aireceipts --svg --theme dark -o r.svg   # dark theme
aireceipts --png -o receipt.png          # rasterized PNG (receipt only)

--theme light|dark picks the palette (default light); -o/--output names the file (defaults receipt.svg / receipt.png). --template works here too, so you can export a grocery or datavis style. A two-session comparison renders as an SVG as well:

aireceipts compare "email format" "intermittently" --svg -o compare.svg

(PNG is receipt-only; compare exports to SVG.)

As data (JSON / CSV)

For FinOps tooling, dashboards, and spreadsheets, emit structured data instead of the text receipt.

JSON (--json) — a versioned, self-describing object:

aireceipts --json "email format"
{
  "schemaVersion": 1,
  "agentLabel": "Claude Code",
  "source": "claude-code",
  "sessionId": "/Users/you/.claude/projects/-Users-dev-signup-form/sess-signup-a1b2c3.jsonl",
  "title": "Add email format validation to the signup form and add a unit test for it. The signup form is in src/components/SignupF…",
  "startedAtMs": 1781775030000,
  "durationMs": 630000,
  "unpriceable": false,
  "modelMix": [
    {
      "model": "claude-opus-4-8",
      "tokens": {
        "input": 16750,
        "output": 668,
        "cacheRead": 109200,
        "cacheCreation": 1400,
        "cacheCreation5m": null,
        "cacheCreation1h": null,
        "total": 128018
      },
      "tokenShare": 0.8716000462972419
    }
  ]
}

(Truncated after the first model — the full object continues with every model, a per-tool breakdown, and totals.) sessionId is the transcript's absolute path. The complete, field-by-field schema — kept in lockstep with the code by a parity test — is docs/json-schema.md.

CSV (--csv) — one summary row per session, RFC 4180:

aireceipts --csv "email format"
schemaVersion,sessionId,agent,title,startedAt,durationMs,primaryModel,totalUsd,inputTokens,outputTokens,cacheReadTokens,cacheCreationTokens,totalTokens
1,/Users/you/.claude/projects/-Users-dev-signup-form/sess-signup-a1b2c3.jsonl,claude-code,Add email format validation to the signup form and add a unit test for it. The signup form is in src/components/SignupF…,2026-06-18T09:30:30.000Z,630000,claude-opus-4-8,0.17670000000000002,19680,897,124200,2100,146877

--csv=tool gives one row per tool instead:

aireceipts --csv=tool "email format"
schemaVersion,sessionId,agent,tool,usd,inputTokens,outputTokens,cacheReadTokens,cacheCreationTokens,totalTokens,callCount
1,/Users/you/.claude/projects/-Users-dev-signup-form/sess-signup-a1b2c3.jsonl,claude-code,Bash,0.05177,6230,134,46000,0,52364,3
1,/Users/you/.claude/projects/-Users-dev-signup-form/sess-signup-a1b2c3.jsonl,claude-code,Edit,0.045575000000000004,4800,159,35200,0,40159,2
1,/Users/you/.claude/projects/-Users-dev-signup-form/sess-signup-a1b2c3.jsonl,claude-code,(thinking/reply),0.031004999999999998,3650,277,26600,0,30527,2
1,/Users/you/.claude/projects/-Users-dev-signup-form/sess-signup-a1b2c3.jsonl,claude-code,Write,0.02905,3200,265,16400,700,20565,2
1,/Users/you/.claude/projects/-Users-dev-signup-form/sess-signup-a1b2c3.jsonl,claude-code,Read,0.019299999999999998,1800,62,0,1400,3262,1

CSV carries full floating-point precision (0.05177), so downstream tools round, not aireceipts. Budget advisory lines never ride along in --csv output — it's a clean data contract.

As a PR comment (pr)

aireceipts pr             # dry-run: print the exact comment body
aireceipts pr --post      # upsert the receipt comment on the PR via gh

aireceipts pr attaches the building session's receipt to the current branch's pull request as a single comment that stays current across pushes. It always prints the body to stdout first, so it's useful even without gh. --post requires the gh CLI authenticated to your repo. Full walkthrough, including the maintainer CI check: docs/pr-receipts.md.

Next