Coding Ledger reads the receipts already on your machine, Git history, Claude Code and Codex session logs, macOS Screen Time, and turns them into an evidence-backed record of your work and your AI's ROI. Everything runs locally. Nothing leaves your machine.
# install (Python 3.10+, zero dependencies)
pipx install coding-ledger
# or
brew tap BMC-INC/coding-ledger && brew install coding-ledger
# run
coding-ledger init --author "Your Name,you@example.com"
coding-ledger scan --roots "$HOME/Projects"
coding-ledger roi
Token usage read straight from local Claude Code and Codex logs, priced at API list rates. API-equivalent value, what it would have cost, not what you paid on a subscription. Unknown models are labeled unpriced, never guessed.
Spend tied to shipped commits and merged PRs: cost per shipped commit, conversion rate per tool, unconverted spend, monthly trends, and your subscription ROI multiple.
Human-versus-AI attribution, total involved time verified against Screen Time, streaks, badges, and a shareable builder field report.
An actual Pro share card. Aggregate evidence only: no prompts, no code, no project names.
Screen time overlaps git, editor, and steering evidence, so it is an envelope, never blindly added. The formula is printed everywhere the number appears:
screen_hours = allowlisted foreground seconds / 3600 (18h/day cap)
uncaptured = max(0, screen_hours - max(human_evidence, shared_ai))
total_involved = max(human_evidence, shared_ai, screen_hours) + independent_ai
= attributed_total + uncaptured
Uncaptured is the reading, reviewing, and debugging time in coding apps that produced no receipt. It credits to you, never to AI.
The ledger is a local SQLite file. It stores timestamps, counts, and aggregates. It never stores:
The free tier's shareable artifact. Five reproducible dimensions, Steering, Planning, Engineering, Execution, Autonomy, plus an archetype and badges with visible thresholds. No model-generated personality judgment: every number recomputes from your own ledger.
Prove how you build without exposing what you build.
| Source | Receipt |
|---|---|
| Git | Author-filtered commits, SHA, timestamps, LOC |
| Claude Code | Session metadata and token usage |
| Codex | Session metadata and token usage |
| Gemini, Grok, Cursor, Aider | Session metadata |
| VS Code, Antigravity | Edit-level activity proxies |
| GitHub | Remote-only commits and LOC, merged PRs |
| Screen Time | Per-app foreground intervals, bundle ids and durations only |