ccwarriors

Token burn rate, ranked. A live leaderboard of AI coding spend — Claude Code, Codex, Gemini CLI, Copilot, OpenCode, Amp and every other agent ccusage can read. See who's burning the most tokens, claim your rank, flex on the timeline.

Live: ccwarriors.xyz · first org board: ns.ccwarriors.xyz (Network School)

Enlist (one command)

curl -fsSL https://api.ccwarriors.xyz/install.sh | bash

That's it. GitHub login opens in your browser, your ccusage totals are read locally, and you're on the board. Re-sync anytime with ccwarriors.

Only two numbers ever leave your machine: your 30-day and all-time cost totals. No code, no prompts, no project data.

How it works

ccwarriors (CLI)                     api.ccwarriors.xyz                ccwarriors.xyz
────────────────                     ──────────────────               ───────────────
ccusage totals ──► POST /ingest ──►  Hono + Postgres                  React + WebSocket
GitHub loopback OAuth                tiers, ranks, rate limits   ──►  live board, rows slide
                                     WebSocket broadcast               as ranks change

• CLI (packages/cli) — zero-dependency single-file Node bundle. GitHub loopback OAuth, reads costs via ccusage, posts to the API. Distributed by the site itself (/install.sh + /cli.js) — every deploy is a CLI release.
• API (apps/server) — Hono + ws on Railway, Postgres via Drizzle. Token-authenticated ingest (rate-limited, sanity-capped, transactional), Minecraft-style tiers (Stone → Netherite), debounced WebSocket broadcasts.
• Web (apps/web) — Vite + React on Vercel. Light/dark, Framer Motion leaderboard that re-sorts live, collectible warrior cards (15 muted anime-nature scenes), pixel Clawd branding (every UI glyph is hand-drawn pixel art — no emojis).

Org boards

Communities get their own co-branded board on a subdomain — same warriors, same data, scoped view. First up: Network School at ns.ccwarriors.xyz.

• Verify with Discord — members link Discord once; the server checks the org's guild and they're on the org board. No bot, no org-admin setup.
• Still on the global board — org members keep their global rank and wear a small org pill there.
• One codebase — an org is a registry entry (slug, accent, theme, guild id) + DNS. No forks, every fix ships to every board.

Want one for your org? Open an org board request.

Sponsors

CCWarriors is free and open source — sponsorships keep the servers burning.

• UPI / card — ccwarriors.xyz/#sponsor (Razorpay)
• Crypto — ETH and Solana addresses on ccwarriors.xyz/#sponsor

Tiers run Wood 🪵 → Netherite 🔥, just like the board.

Local development

pnpm install

# backend — in-memory Postgres (PGlite) + 15 seeded demo warriors + simulated
# live spend, on :8787 (demo data is local-only, never in production)
pnpm --filter server dev

# frontend — :5173
pnpm --filter web dev

Node ≥ 20 and pnpm required. See DEPLOY.md for production setup (Railway, Vercel, DNS, GitHub OAuth app) and apps/server/.env.example for configuration.

Repo layout

apps/server     Hono API + WebSocket + Drizzle/Postgres
apps/web        Vite + React leaderboard (serves the CLI installer)
packages/cli    the ccwarriors CLI
scripts/        zero-dep PNG generators (logo, OG banner, favicon)
docs/           design spec + implementation plans

---

Built with ❤️ by Manu