Claude Code Leaderboard

Track your Claude Code token usage and compete on the global leaderboard!

Installation

npm install -g tokenflex

Or use directly with npx:

npx tokenflex upload

Quick Start

Submit Your Token Score

1. Install the package:

   npm install -g tokenflex

2. Upload your tokens:

   tokenflex upload

   First time? You'll be prompted to choose a display name for the leaderboard.

3. Check your ranking: After successful upload, visit https://tokenflex.me to see your score on the leaderboard!

What Happens When You Run tokenflex upload

1. Setup (first time only):

   • Prompts you to choose a display name
   • Auto-detects your Claude Code username if available
   • Saves configuration locally

2. Token Extraction:

   • Reads your Claude Code token usage from ~/.claude/stats-cache.json
   • Falls back to tokscale or manual parsing if needed

3. Upload:

   • Sends your token count to the leaderboard server
   • Displays confirmation with your total tokens

4. View Results:

   • Link to https://tokenflex.me to see your ranking

Example

$ tokenflex upload

👋 Welcome to Token Flex!
Let's set up your account...

? Choose a display name for the leaderboard: your_name

✅ Setup complete!

📊 Extracting your token usage...
🚀 Uploading to leaderboard...
✅ Successfully uploaded your token usage!
Total tokens: 150000

🏆 Check your score on https://tokenflex.me

How It Works

Token Extraction

The CLI reads your Claude Code token usage from multiple sources:

1. Primary: ~/.claude/stats-cache.json - Most accurate
2. Fallback: tokscale package
3. Last Resort: ~/.claude/history.jsonl - Manual parsing

Privacy

• Only total token count is uploaded
• No conversation content or prompts are sent
• Your data is anonymized
• Uploads are completely opt-in

Configuration

Configuration is stored in:

• ~/.config/configstore/tokenize.json

To reset your configuration and start over:

rm ~/.config/configstore/tokenize.json
tokenflex upload

Troubleshooting

"No Claude Code history found"

Make sure you have:

1. Used Claude Code at least once
2. Have token usage data in ~/.claude/stats-cache.json or ~/.claude/history.jsonl

"Upload failed"

Check:

1. Your internet connection
2. The leaderboard server is accessible

"Username already taken"

Choose a different display name:

rm ~/.config/configstore/tokenize.json
tokenflex upload

License

MIT