aieracard

Your AI usage — tokens, streaks, models — on one permanent, shareable card.

npx aieracard

The CLI collects usage locally from:

• Claude Code — local JSONL logs (~/.claude/projects), fully automatic
• Codex — local JSONL under ~/.codex/sessions (override with CODEX_HOME)
• Cursor — all-time usage via your own cursor.com session (token resolved locally, sent only to cursor.com); CSV export as fallback
• OpenRouter — optional management API key (/credits + /activity), collected only when explicitly enabled with --openrouter. Tokens are last 30 days; all-time spend stays on the source object and is not rolled into the card's aggregate "compute spent"

It then shows you the exact JSON that would be uploaded — aggregate numbers only: token counts, cost totals, active days, streaks, model names. Never prompts, code, file paths, or project names. --dry-run uploads nothing at all.

On confirmation you get a permanent card URL like ai-era-card.vercel.app/s/mmi5GrqvJt that unfurls into a stats card when shared.

Options

--dry-run              build and print the payload, upload nothing
--json-out <file>      also write the payload to a local file
--yes / --force        skip prompts / skip upload confirmation
--openrouter           collect OpenRouter usage; prompts for a key if needed
--openrouter-key <k>   OpenRouter API key (or OPENROUTER_API_KEY env; requires --openrouter)
--cursor-cookie <t>    Cursor web session token (auto-detected if omitted)
--cursor-csv <path>    usage CSV export (fallback if the API path fails)
--no-claude-code / --no-codex / --no-cursor
--no-openrouter        legacy no-op (OpenRouter is already opt-in)
--handle <name>        display name on the card (unverified)
--no-baseline          don't save the local baseline file (see below)
--open                 open the card URL in your browser

Local baseline (deltas)

After a successful upload the CLI saves a small local file, ~/.aieracard/state.json, containing only the same aggregate numbers that are already public on your card (plus the date, schema version, and which sources were enabled). On your next run it uses that file to print "+240M tokens since your last card". The file never leaves your machine; delete it anytime, or pass --no-baseline to skip writing it.

Stats are self-reported, like any year-in-review.