comped

What your AI coding subscription would have cost at full API price, read from the session logs your tools already keep. Your logs never leave your machine.

npx comped

That is the whole thing. It reads the logs your AI coding tools already write, prices the last 30 days at the provider's public API rates, and prints a card with your comp score: how many times over your subscription paid for itself. Then it posts just that score to gotcomped.com and tells you your rank.

What it needs

Python 3.9 or newer on your PATH. Every Mac has it. comped is standard-library Python; this package has no node dependencies and no install script. bin/comped.js finds an interpreter and runs payload/comped.py. That is all it does.

What it reads, and what it sends

• Reads: session logs under ~/.claude/projects, ~/.codex/sessions, ~/.pi/agent/sessions and ~/.local/share/opencode/storage. Nothing else.
• Never reads: ~/.claude.json, ~/.codex/auth.json, or any credential, keychain or token file. Which AI you use is worked out from the model ids already in those logs. Your plan tier is never read from your account.
• Sends: one thing, once, after the card is written: your score. The exact payload is saved to ~/comped/comped-rank.json before it goes, so you can read it. leaderboard=false sends nothing at all, and then the run makes no network call whatsoever.
• Writes: only under ~/comped. Every path is listed in the report.

Options

Arguments are key=value, the same ones the rote Play takes:

npx comped handle=yourname            # your name on the board instead of anon-xxxx
npx comped plan=claude-pro-20         # the tier you actually pay for
npx comped leaderboard=false          # the card only, no network call at all
npx comped days_back=7                # a different window
npx comped --help                     # all fourteen

Try it on the sample logs that ship with it, before pointing it at your own:

npx comped claude_dir=resources/fixtures/claude codex_dir=resources/fixtures/codex leaderboard=false

Other ways to run it

• No node: curl -fsSL https://gotcomped.com/comped.sh | sh
• As an inspectable rote Play, with a consent screen listing every path it will touch: curl -fsSL https://gotcomped.com/run.sh | sh

Same code, same parameters, same card. Full docs at https://gotcomped.com/docs.html.

MIT licensed. Source: https://github.com/rajkaria/comped