clawdboard
v0.3.2
Published
AI coding agent leaderboard — track and compare usage, costs, tokens, streaks, and model breakdowns across Claude Code, OpenCode, and Codex.
Maintainers
Readme
clawdboard
Track and compare your AI coding agent usage across developers. Supports Claude Code, the Claude desktop app (Cowork / Dispatch), OpenCode (incl. Go and Zen tiers), Codex CLI, Gemini CLI, GitHub Copilot CLI, and Antigravity (opt-in). See who's spending the most, longest streaks, model breakdowns, and more.
Quick Start
npx clawdboardThat's it. This opens your browser, authenticates via GitHub, syncs your usage data, and installs an auto-sync hook — all in one step.
How It Works
- Auth — Sign in with GitHub (device flow, no secrets in the terminal)
- Extract — Reads your local usage logs from each supported tool (
~/.claude/,~/.local/share/opencode/,~/.codex/,~/.gemini/,~/.copilot/, and the Claude desktop app's session directory on macOS) - Sync — Uploads aggregate metrics (tokens, cost, models) to the leaderboard
- Auto-sync — A Claude Code hook syncs in the background every 2 hours
Updating
If you onboarded the recommended way (npx clawdboard), you don't need to do anything — you're already on the latest version. The auto-sync hook installed during auth runs npx -y clawdboard hook-sync on every Claude Code session-end, which pulls the latest published version from npm (subject to npx's metadata cache, typically ~10 minutes). New releases roll out to all active hook users automatically within an hour or so.
If you installed globally (npm install -g clawdboard), the hook uses your pinned binary instead and won't auto-update. Run npm update -g clawdboard to upgrade.
Commands
| Command | Description |
|---|---|
| clawdboard auth | Authenticate with GitHub |
| clawdboard sync | Manually sync usage data |
| clawdboard rank | Show your rank and percentile |
| clawdboard leaderboard | Show the top users |
| clawdboard setup | Re-install the auto-sync hook |
Options
clawdboard sync --since 2025-01-01 # Sync from a specific date
clawdboard sync --dry-run # Preview without uploading
clawdboard leaderboard --period 30d # 7d, 30d, this-month, ytd
clawdboard leaderboard --limit 20 # Show more usersPrivacy
Only aggregate numbers leave your machine — never your prompts, code, or project names.
Every field is explicitly allowlisted and validated through a Zod schema before upload. The full extraction logic is in src/extract.ts.
What's shared: date, token counts, cost, model names. What's never shared: prompts, responses, file paths, project names, session IDs.
Claude Code Plugin
clawdboard is also available as a Claude Code plugin with slash commands:
/clawdboard:stats— Check your rank/clawdboard:sync— Trigger a sync/clawdboard:leaderboard— View the leaderboard
Requirements
- Node.js 18+
- A Claude Code installation with usage history
License
MIT
