AI Coding Usage Card

AI Coding Usage Card

A self-hosted GitHub profile card that shows how many tokens (and how much API-equivalent money) you've burned across your AI coding tools — Claude Code, Codex, Gemini CLI, Copilot CLI, OpenCode, and everything else ccusage detects.

No external services. No accounts. No API keys. Everything runs on your machine against your own local logs, and the card is just an SVG committed to your profile repo.

Live examples — all four variants, auto-updating daily from my own usage:

ai-usage-full.svg (846×225)

ai-usage-combo.svg (846×195) — half + grass merged in one SVG

ai-usage-half.svg (423×195)  ·  ai-usage-grass.svg (423×195) — side by side = one full width

ai-usage-half-grass.svg (423×335)

Variants

One run generates all four — embed whichever you like:

What it shows

"API-equivalent" because subscription users (Claude Max etc.) don't actually pay per token — the number is what the same usage would cost on the API. That's the fun part.

How it works

A scheduler (Task Scheduler / cron / launchd) runs the script once a day. Each run recomputes everything from your local logs, fetches fresh FX rates, merges the result into that device's ledger, and commits the regenerated SVG.

Setup

Requirements: Node 18+, GitHub CLI logged in (gh auth login, repo scope is enough), and a profile repo (the public repo named after your username).

1. Fork this repository, then clone your fork

2. Choose a permanent device ID. Use a different ID on every computer and never rename it later.

3. Test run

   Add --dry-run to skip the GitHub commit and write the 5 SVGs plus the merged snapshot JSON to ./out/ instead — handy for checking numbers before they go live.

4. Embed in your profile README (any of the four variants)

5. Schedule it daily

   Windows…