ccclub — coding-agent leaderboard among friends

ccclub reads local coding-agent usage logs, aggregates them into anonymous 30-minute token/cost summaries (no prompts, no code, no file paths), and uploads only those counters to a group leaderboard the user shares with friends.

Check rank and spend (most common request)

Run:

ccclub --json

Output shape:

{
  "period": "daily",
  "groups": [{
    "group": { "name": "...", "code": "ABC123", "memberCount": 67 },
    "start": "...", "end": "...",
    "rankings": [{
      "rank": 11, "displayName": "...", "costUSD": 19.02,
      "totalTokens": 47100000, "models": ["..."], "agents": ["claude"],
      "chatCount": 27
    }]
  }]
}

Time windows: ccclub --json -d 1 (yesterday), -d 7, -d 30, -d all. The user's own row: match displayName against their name, or compare all rows. Costs are USD. groups contains one entry per group the user joined.

If ccclub is not on PATH, the user hasn't set it up — see Setup below. If it prints "Not initialized", run setup too.

Setup (first time)

• Create a group: npx ccclub init (interactive: asks display name once)
• Join a friend's group: npx ccclub join <6-LETTER-CODE>
• Both install background sync automatically; nothing else to configure.

Other commands

• ccclub statusline on|off — Claude Code statusline (model · 5h/7d limits · rank)
• ccclub show-data — audit exactly what gets uploaded (privacy check)
• ccclub sync — force an immediate sync

The leaderboard counts coding agents only; personal-assistant usage (e.g. OpenClaw) is excluded from rankings server-side.

• Group dashboard (shareable URL): https://ccclub.dev/g/<CODE>

HTTP fallback (no CLI needed, read-only)

GET https://ccclub.dev/api/rank/{groupCode}?period=daily&tz={utcOffsetMinutes}

periods: daily | yesterday | weekly | monthly | all-time. Full API notes: https://ccclub.dev/llms.txt