boardq
v0.3.0
Published
Join a BoardQ Claude Code tokens leaderboard and report your token spend automatically.
Downloads
898
Maintainers
Readme
boardq
Join a BoardQ Claude Code tokens leaderboard and automatically report how many tokens you spend — compete with your team or the world for the top spot.
npx boardq join <boardId> --token <your-token>You get your personal --token from the leaderboard page (open the board on boardq.io and click Join this leaderboard).
How it works
- Runs
boardq joinonce. It installs a Claude Code hook that reports your usage automatically after each session — no terminal needs to stay open. - Reads Claude Code's own local usage logs in
~/.claude/projects/**/*.jsonl(the same dataccusageuses). Nothing else is sent — just your token totals and an estimated cost. - The moment you join is your baseline: only tokens you spend after joining count toward your score. Your historical usage is never uploaded or ranked.
- Reports are throttled to at most once every ~5 minutes, plus a final flush when a session ends.
Commands
| Command | What it does |
| --- | --- |
| boardq join <boardId> --token <t> | Join a board and install auto-updating hooks |
| boardq report <boardId> | Send a single update now |
| boardq uninstall [boardId] | Remove the auto-update hooks |
| boardq status | Show your local token usage (nothing is uploaded) |
| boardq help | Show help |
join options
| Flag | Default | Description |
| --- | --- | --- |
| --token <t> | — | Your personal token (required) |
| --name <n> | — | Override your display name |
| --no-hook | — | Don't install the hook (report once and exit) |
| --watch | — | Keep the terminal open and report on a timer instead |
| --interval <m> | 15 | With --watch, minutes between reports |
| --once | — | Report a single time and exit |
| --api <url> | production | Override the API base URL |
Privacy
boardq never reads the contents of your prompts or code — only the token-count and model fields Claude Code records for each turn. Config (your board token) is stored at ~/.config/boardq/config.json with 600 permissions.
Requirements
- Node.js ≥ 18
- Claude Code installed and used at least once
Learn more: https://www.boardq.io/tokens-leaderboard
