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

• 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/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