# ccclub

> Claude Code and Codex leaderboard among friends. The ccclub CLI reads local
> coding-agent usage logs (Claude Code, Codex, OpenCode, Amp, pi-agent),
> aggregates them into anonymous 30-minute token/cost summaries, and uploads
> only those counters to group leaderboards. No prompts, no code, no file
> paths ever leave the machine. Non-coding assistant usage is excluded from
> rankings server-side.

## CLI

- Install and create a group: `npx ccclub init`
- Join a friend's group: `npx ccclub join <CODE>`
- Leaderboard (human): `ccclub` — time windows via `-d 1|7|30|all`
- Leaderboard (machine-readable): `ccclub --json` — raw JSON on stdout,
  suitable for jq, scripts, and agents. Shape: { period, groups: [RankResponse] }
- Claude Code statusline (model · 5h/7d limits · rank): `ccclub statusline on|off`
- Audit what gets uploaded: `ccclub show-data`

## Public HTTP API (no auth required)

- GET https://ccclub.dev/api/rank/{groupCode}?period=daily&tz=480
  - period: daily | yesterday | weekly | monthly | all-time
  - tz: local UTC offset in minutes (e.g. 480 for UTC+8, -300 for UTC-5)
  - Returns JSON: { group: { name, code, memberCount }, period, start, end,
    rankings: [{ rank, userId, displayName, totalTokens, inputTokens,
    outputTokens, costUSD, models, agents, agentBreakdown, chatCount, ... }] }
  - Use groupCode "global" for the public opt-in leaderboard.
- GET https://ccclub.dev/api/pricing
  - Model pricing table (USD per million tokens) used for cost calculation,
    refreshed daily from LiteLLM. Supports ETag / If-None-Match revalidation.

## Web

- Group dashboard (HTML, live): https://ccclub.dev/g/{groupCode}
- Invite page: https://ccclub.dev/invite/{groupCode}

## Source

- GitHub: https://github.com/mazzzystar/ccclub (MIT)