Get on the map

Your rank comes from the Claude Code and Codex logs already on your computer. token-sync reads the token counts from them, never your prompts, code or file paths, and uploads them to your account. You choose whether to appear publicly.

You need: a GitHub account, Node.js 22.18 or newer, and Claude Code or Codex used on this computer.

1. See what would be sent (optional)

npx @tokenhomepage/token-sync --dry-run --pretty

Prints the exact upload to your screen and sends nothing. A summary of your totals appears at the bottom.

2. Connect this computer

npx @tokenhomepage/token-sync login

It prints a link and a code like KQZD-WTBM. Leave the terminal open.
Open the link, sign in with GitHub, check the code matches, and click Approve.
The terminal says Authorized within a few seconds.

3. Upload your usage

npx @tokenhomepage/token-sync upload

Sends your token counts and prints your totals. It's safe to run as often as you like: records already uploaded are never counted twice. Run it again whenever you want your rank updated.

4. Go public

Open your account page, pick a display name, tick Show me on the public homepage and save. Your ad appears on the map within about a minute. Until then, nothing about you is public.

How you're ranked

Ranked tokens = uncached input + cache writes + output, across Claude Code and Codex combined. Cache reads are shown on your profile but don't count toward rank, so long cached sessions can't dominate the board.

Good to know

Several computers? Run login and upload on each one. They all add to the same account.
Logs in a custom folder? Pass each projects or sessions folder with --claude-dir or --codex-dir. These replace the default locations, so list every folder you want counted. The dry run shows which folders were scanned.
Upload interrupted or rate-limited? Just run upload again later. Records the server already has are skipped, never counted twice.
Prefer a permanent install? npm install -g @tokenhomepage/token-sync, then run token-sync login, token-sync upload and so on.
Stop or leave: npx @tokenhomepage/token-sync logout disconnects this computer. Your account page can unlist you, delete usage, or delete your account entirely. See Privacy.

Questions or problems: hello@tokenhomepage.com.