A global leaderboard for tracking Claude Code usage.
Compete with other Claude users, earn badges, join teams, and climb the ranks.
Website ·
Plugin ·
Features ·
Development ·
API ·
Discord
Demo
Features
-
Global Leaderboards — Compete across 6 ranking categories
- Token Usage
- Messages & Sessions
- Tool Calls
- Prompt Uniqueness
- Weighted Score (composite)
- Estimated Spend
-
User Profiles — View detailed stats including usage heatmaps, badges, and tier progression
-
Badge System — Earn achievements for milestones and ranking positions
- Milestone badges (Token Millionaire, Tool Master, etc.)
- Ranking badges (Top 100, Top 10, #1)
- Team badges
-
Team Competition — Create or join teams to compete with aggregated metrics
-
Tier Progression — Advance through Bronze, Silver, Gold, Platinum, and Diamond tiers
-
Desktop App — Tauri-based app that monitors your Claude Code logs in real-time, syncs metrics, and displays a tray widget with your stats
-
Claude Code Plugin — Install directly in Claude Code to sync usage, view leaderboards, check badges, and track stats without leaving your terminal
Claude Code Plugin
A way to use Claude Rank directly in Claude Code. It syncs your usage automatically in the background and gives you access to leaderboards, badges, and stats directly in your terminal.
Install
/plugin marketplace add bicro/claude_rank
/plugin install claude-rank
Then run /claude-rank:setup to configure the statusline HUD.
Commands
| Command | Description |
|---|
/claude-rank:leaderboard [category] | View the global leaderboard |
/claude-rank:profile | View your profile card with stats and activity |
/claude-rank:badges | See your earned badges and achievements |
/claude-rank:history | View your usage history and daily trends |
/claude-rank:team | View your team dashboard |
/claude-rank:authenticate | Connect a social account (Google/GitHub/Discord) |
/claude-rank:setup | Configure the statusline HUD |
/claude-rank:uninstall | Remove the plugin |
Project Structure
claude_rank/
├── claude-code-plugin/ # Claude Code plugin (MCP server + commands)
├── server/ # Bun.js backend (TypeScript)
├── desktop/ # Tauri 2.x desktop app (Rust + TypeScript)
├── website/ # Static website (HTML/JS/CSS)
├── dev.ts # Dev script (starts server + desktop)
└── Dockerfile # Production container
Tech Stack
| Component | Technology |
|---|
| Backend | Bun, TypeScript, PostgreSQL |
| Auth | Better Auth (Google, GitHub, Discord, Twitter, LinkedIn) |
| Plugin | Node.js, MCP SDK |
| Desktop | Tauri 2.x, Rust |
| Website | Vanilla HTML/JS/CSS |
Development
Prerequisites
Full Stack (Server + Desktop)
bun run dev.ts
Server Only
cd server
bun run dev
Desktop App Only
cd desktop
bun install
bun run dev
Website
The website is served statically by the server at /.
API
The server exposes a REST API at /api:
| Endpoint | Method | Description |
|---|
/api/users | POST | Register a new user |
/api/users/{hash} | GET | Get user profile & metrics |
/api/users/{hash}/badges | GET | Get user's badges |
/api/users/{hash}/history | GET | Get metric history |
/api/users/{hash}/heatmap | GET | Get hourly usage heatmap |
/api/users/{hash}/daily-ranks | GET | Get daily rank snapshots |
/api/users/by-username/{username} | GET | Lookup user by username |
/api/users/{hash}/connect | POST | Connect OAuth account |
/api/sync | POST | Sync usage metrics |
/api/leaderboard/{category} | GET | Get leaderboard rankings |
/api/teams | POST | Create a team |
/api/teams/{hash} | GET | Get team details |
/api/teams/{hash}/join | POST | Join a team |
/api/teams/{hash}/history | GET | Get team metric history |
/api/teams/leave | POST | Leave current team |
/api/badges | GET | Get all badge definitions |
/api/hot | GET | Get trending users |
/api/auth/* | * | Better Auth OAuth routes |
Environment Variables
Copy .env.example to .env.local and fill in the values:
cp .env.example .env.local
