# ccclub — Claude Code & Codex Leaderboard Among Friends > Claude Code and Codex leaderboard among friends. Track coding agent token usage, costs, active status, and agent mix across Claude Code, Codex, OpenCode, Amp, and pi-agent. No signup, no config. Website: https://ccclub.dev GitHub: https://github.com/mazzzystar/ccclub Discord: https://discord.gg/6QbGWJUVHq --- ## Quick Start ```bash # 1. Initialize (creates your group + enables auto-sync) npx ccclub init # 2. Share the invite link with friends # (printed after init — looks like https://ccclub.dev/invite/YHAW6P) # 3. See the leaderboard ccclub ``` --- ## Installation ```bash npx ccclub init ``` This single command: - Asks for your display name (auto-detects from git config) - Creates your group with a 6-letter invite code - Detects supported coding agent logs on your machine - Installs automatic usage sync - Globally installs `ccclub` so you can run it without `npx` --- ## Supported Coding Agents ccclub automatically detects local usage logs from: | Agent | Default location | |-------|------------------| | Claude Code | `~/.config/claude/projects`, `~/.claude/projects` | | Codex | `~/.codex/sessions` | | OpenCode | `~/.local/share/opencode` | | Amp | `~/.local/share/amp/threads` | | pi-agent | `~/.pi/agent/sessions` | If you use the default locations, there is nothing to configure. Custom locations are supported with `CLAUDE_CONFIG_DIR`, `CODEX_HOME`, `OPENCODE_DATA_DIR`, `AMP_DATA_DIR`, and `PI_AGENT_DIR`. --- ## Inviting Friends After init, you get an invite link like: https://ccclub.dev/invite/YHAW6P Share this link via iMessage, Slack, Discord, etc. The link shows: - Your group name and member count - A one-command join instruction - A rich preview card when shared in messaging apps Friends join by running: ```bash npx ccclub join YHAW6P ``` --- ## Viewing the Leaderboard ### CLI ```bash ccclub # Today's leaderboard (default) ccclub -d 1 # Yesterday ccclub -d 7 # Last 7 days ccclub -d 30 # Last 30 days ccclub -d all # All time ccclub --global # Global public leaderboard ccclub --no-cache # Exclude cache tokens from count ccclub --all # Show all members including inactive ccclub -g XYZABC # Show a specific group ``` ### Web Dashboard Every group has a live web dashboard at: https://ccclub.dev/g/YHAW6P Features: - Real-time leaderboard with cost, tokens, turns, $/turn, and agent mix - Monthly ROI calculation (for users with subscription plans) - Activity chart showing usage patterns over time - Active member indicators - Period selector (Today, Yesterday, 7d, 30d, All Time) ### Global Leaderboard Public users appear on the global leaderboard: https://ccclub.dev/g/global --- ## All Commands | Command | Description | |---------|-------------| | `ccclub init` | Create a group and get started (first-time setup) | | `ccclub join ` | Join a group with a 6-letter invite code | | `ccclub` | Show today's leaderboard | | `ccclub -d 1\|7\|30\|all` | Time window (yesterday / 7d / 30d / all time) | | `ccclub --global` | Global public leaderboard | | `ccclub --no-cache` | Exclude cache tokens from total | | `ccclub --all` | Show all members including inactive ones | | `ccclub create` | Create an additional group | | `ccclub leave [CODE]` | Leave a group | | `ccclub sync` | Manual sync; auto-sync also runs after setup | | `ccclub sync --force` | Re-scan and upload all local usage logs | | `ccclub profile` | View your profile | | `ccclub profile --name ` | Change display name | | `ccclub profile --avatar ` | Set avatar URL | | `ccclub profile --public` | Show in global ranking | | `ccclub profile --private` | Hide from global ranking | | `ccclub profile --plan pro\|max100\|max200\|api` | Set subscription plan (for ROI calculation) | | `ccclub profile --url ` | Link your name to a URL | | `ccclub show-data` | Preview exactly what gets uploaded | --- ## Profile & Plans Set your subscription plan to see Monthly ROI in the leaderboard: ```bash ccclub profile --plan max200 # Max plan ($200/mo) ccclub profile --plan max100 # Max plan ($100/mo) ccclub profile --plan pro # Pro plan ($20/mo) ccclub profile --plan api # API user (free tier) ``` ROI shows how much value you're getting: `$200/1610%` means you've used $3,220 worth of tracked agent usage on a $200 plan. Other profile options: ```bash ccclub profile --public # Appear on global leaderboard ccclub profile --url https://github.com/you ccclub profile --avatar https://example.com/photo.jpg ``` --- ## Privacy ccclub reads **only** agent source, token counts, cost estimates, model names, and number of calls from local usage logs written by Claude Code, Codex, OpenCode, Amp, and pi-agent. **Never uploaded:** - Prompts or responses - Code or file contents - File paths or project names - Conversation data Run `ccclub show-data` to see exactly what gets uploaded. --- ## How Syncing Works - **Automatic**: `ccclub init` installs a Claude Code hook for session-end sync and a lightweight background sync for other supported agents - **Manual**: Run `ccclub sync` anytime - **Full re-scan**: Run `ccclub sync --force` to re-scan local logs - Usage data is aggregated into 30-minute blocks before upload --- ## Multiple Groups You can be in multiple groups simultaneously: ```bash ccclub create # Create another group ccclub join XYZABC # Join a friend's group ccclub -g XYZABC # View a specific group ccclub leave XYZABC # Leave a group ``` Running `ccclub` shows all your groups at once. --- ## Web Features | URL | Description | |-----|-------------| | `ccclub.dev` | Landing page | | `ccclub.dev/g/` | Group dashboard (live leaderboard + activity chart) | | `ccclub.dev/g/global` | Global public leaderboard | | `ccclub.dev/invite/` | Invite page (share this link to invite friends) | --- ## FAQ **Q: Does ccclub read my code or prompts?** A: No. It only reads usage metadata (token counts, costs, model names) from supported coding agent logs. **Q: Do I need to create an account?** A: No. Just run `npx ccclub init`. No email, no password, no signup. **Q: How does auto-sync work?** A: `ccclub init` installs a Claude Code hook for session-end sync and a lightweight background sync for other supported agents. You can also sync manually. **Q: Do I need to configure each coding agent?** A: No. ccclub detects supported logs from their default local locations. Custom locations are optional. **Q: Can I be in multiple groups?** A: Yes. Run `ccclub create` for a new group or `ccclub join ` to join another. **Q: What is Monthly ROI?** A: If you set your plan (`ccclub profile --plan max200`), the leaderboard shows tracked usage cost relative to your subscription cost. 1610% means you used 16.1x what you paid. **Q: How do I appear on the global leaderboard?** A: Run `ccclub profile --public`. Your usage will appear at ccclub.dev/g/global. **Q: Can I remove my data?** A: Leave all groups with `ccclub leave` and delete `~/.ccclub/`. Your data will expire from the server. --- MIT License · https://github.com/mazzzystar/ccclub