Claude Rank

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

• Wrapped — Spotify-Wrapped-style monthly recap of your Claude Code usage. Includes totals, busiest day, power hour, 24×7 heatmap, peak concurrency, month-over-month deltas, favorite model breakdown, and team comparison. Each user gets a shareable OG image card per month.

• 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

• Bun
• Rust (for the desktop app)

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/{hash}/wrapped/{YYYY-MM}	GET	Get monthly Wrapped recap summary
/api/users/{hash}/wrapped/{YYYY-MM}/og.png	GET	Render Wrapped OG share image
/api/users/{hash}/wrapped/status	GET	Check if a new Wrapped is ready (and unviewed)
/api/users/{hash}/wrapped/{YYYY-MM}/seen	POST	Mark a Wrapped as viewed
/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

Variable	Required	Description
DATABASE_URL	Yes	PostgreSQL connection string
BETTER_AUTH_SECRET	Yes	Auth secret (openssl rand -base64 32)
BETTER_AUTH_URL	Yes	Server URL (e.g. http://localhost:3001)
WIDGET_BASE	Yes	Widget base URL
RANKING_API_BASE	Yes	API base URL
GOOGLE_CLIENT_ID / _SECRET	No	Google OAuth credentials
GITHUB_CLIENT_ID / _SECRET	No	GitHub OAuth credentials
DISCORD_CLIENT_ID / _SECRET	No	Discord OAuth credentials
TWITTER_CLIENT_ID / _SECRET	No	Twitter/X OAuth credentials
LINKEDIN_CLIENT_ID / _SECRET	No	LinkedIn OAuth credentials

Deployment

The server is containerized with Docker and deployed on Render.

docker build -t claude-rank .
docker run -p 10000:10000 claude-rank

License

This project is licensed under the MIT License - see the LICENSE file for details.