# Tokens

A CLI and public leaderboard that reads local session files 41 AI coding clients already write to disk, totals token usage locally, and uploads only aggregate counts and timestamps, never prompts or file contents, with an iOS companion app.

Tokens is a leaderboard for AI coding tool usage. Its CLI reads the session files that clients such as Claude Code, Codex CLI, Cursor, Copilot, Gemini CLI, OpenCode and dozens of others already write to disk, totals the token usage locally, and submits only the totals: token counts, model names, client names and timestamps. Prompts, completions, file contents and paths never leave the machine, a claim the project backs by publishing the parser for each client, the code that turns those reads into daily totals, and the exact submit payload, plus a dry-run flag that prints what would be uploaded without uploading it.

An iOS app shows a user's rank and usage without opening a browser, with shareable rendered cards and home-screen or lock-screen widgets for the day's tokens, running total and rank; it requires no sign-in and instead reads a given GitHub username's public profile.

All 41 supported clients are detected automatically if installed with existing session data, and the CLI installs and logs in with a single command.

Website: https://tokens.ci
