Claude Cup gives you a live trophy in your terminal that fills based on your Build Rate - a productivity metric that rewards meaningful edits, clean runs, and commits. Compete on a worldwide leaderboard.
Requires Node.js 18+ and Claude Code · Works on macOS, Linux, Windows
┌─────────────────────────────────────────────────────┐ │ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░░░ Build Rate ⬆ 4.21 │ │ │ │ ___ │ │ / \ │ │ | | │ │ |▓▓▓▓▓| │ │ |▓▓▓▓▓| │ │ |▓▓▓░░| │ │ |_____| │ │ /=======\ │ │ /=========\ │ │ │ │ Rank #112 · Top 8% · Tier Craftsman │ │ │ │ ↑ #111 alex_builds BR 4.38 │ │ → #112 you BR 4.21 │ │ ↓ #113 nadia_dev BR 4.05 │ │ │ │ Tokens today 142 k Cost ~$0.71 Eco off │ └─────────────────────────────────────────────────────┘
A single command launches the whole experience: trophy, leaderboard, and all.
Your productivity score. A rolling 7-day weighted metric that rewards net file edits, successful terminal runs, and git commits - while dividing by kilotokens consumed. Quality over quantity.
See exactly where you rank among builders across the globe. Updates every few minutes. Watch your position change in real time as you code, and get a notification when you overtake someone.
On first launch Claude Cup registers itself as an MCP server with Claude Code. Hook events (edits, tool calls, prompts) flow directly into a local SQLite database for accurate, real-time tracking.
An ASCII World Cup trophy that fills up based on your global percentile rank. See it grow as you climb the leaderboard, a literal visual of your progress as a builder.
Press e in the TUI to cap token usage. Claude Cup sets environment limits in Claude Code's config, then fully restores your original settings the moment you turn eco mode off.
A browser-based view at localhost:4690 showing your same stats with an interactive trophy. Start it with npx claude-cup --web or run headless alongside your regular workflow.
No configuration files. No API keys. Just one command.
Run npx claude-cup in your terminal. Claude Cup registers with Claude Code automatically on first launch. No manual setup, no config files.
Continue using Claude Code exactly as before. Claude Cup hooks into your sessions in the background, tracking edits, commits, and tool calls through the MCP integration.
Your Build Rate and leaderboard rank update every few minutes. The trophy fills as you climb. Compete with builders worldwide during the 2026 World Cup window.
Claude Cup sets itself up automatically. No config files, no API keys, no accounts required.