clawdboard-oss
morgen-so/clawdboard-oss
The open-source leaderboard for AI coding agents. Track and compare usage across Claude Code, OpenCode, and Codex.
Instalação
npx convez-ai morgen-so/clawdboard-oss1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
clawdboard
The open-source leaderboard for AI coding agents. Track and compare usage, costs, tokens, streaks, and model breakdowns across developers. Supports Claude Code, OpenCode, and Codex.
How It Works
- Run
npx clawdboardin your terminal - Sign in with GitHub (device flow — no secrets in the terminal)
- Your local usage logs are extracted, aggregated, and synced
- A hook auto-syncs every 2 hours in the background
Privacy first: Only aggregate numbers (date, token counts, cost, model names) leave your machine. Prompts, code, file paths, and project names never do.
Features
- Leaderboard — sort by cost, tokens, or streaks across 7d / 30d / YTD
- Profiles — usage chart, activity heatmap, model breakdown, earned badges
- Teams — create a team, invite via link, compete and track AI adoption
- Shareable cards — OG images and social sharing for profiles and teams
- i18n — English, French, German, Spanish
Tech Stack
- Framework: Next.js 15 (App Router, Turbopack)
- Language: TypeScript
- Auth: NextAuth v5 (GitHub OAuth)
- Database: Neon (serverless Postgres) + Drizzle ORM
- Styling: Tailwind CSS v4
- Hosting: Vercel
Quick Start
Requires Node.js 18+ and Docker.
git clone https://github.com/morgen-so/clawdboard-oss.git
cd clawdboard
npm install
npm run db:setup # starts Postgres, pushes schema, seeds sample data
npm run dev # http://localhost:3001 — sign in as dev-alice
No secrets, no Neon account, no GitHub OAuth app needed for local dev.
Self-Hosting / Production
For production, set these environment variables (see .env.example):
- DATABASE_URL — Neon connection string (or any Postgres)
- AUTH_SECRET —
openssl rand -base64 32 - AUTH_GITHUB_ID / AUTH_GITHUB_SECRET — GitHub OAuth App with callback
https://your-domain/api/auth/callback/github
Push the schema and create the materialized view:
npx drizzle-kit push
curl http://localhost:3001/api/cron/refresh
Project Structure
src/
app/ # Next.js App Router pages and API routes
components/ # React components
lib/ # Shared utilities (db, auth, env, sync)
actions/ # Server actions
cli/ # CLI package (npm: clawdboard)
opencode-plugin/# OpenCode plugin (npm: clawdboard-opencode)
Contributing
See CONTRIBUTING.md for setup instructions and guidelines.
Security
See SECURITY.md for reporting vulnerabilities.
License
Built with Claude Code by the team at Morgen.