tokenhoggers 0.1.1

Track your AI usage across Claude Code, Cursor, ChatGPT, Gemini, and more

Token Hoggers

Gamified, tool-agnostic AI usage leaderboard. Track and compete on your AI usage across Claude Code, Cursor, Gemini, ChatGPT, Copilot, and more.

Inspired by claude_rank but tool-agnostic, with an RPG character system built on the AMI (AI Maturity Index) framework.

How It Works

1. Install the CLI — pip install tokenhoggers
2. Sign in — Google OAuth at tokenhoggers.ai
3. Sync — tokenhoggers sync reads your local AI tool stats (counts only, never content)
4. Compete — See your rank, level, tier, and RPG stats on the leaderboard

Privacy-First

We collect counts and timestamps only. Never prompt text, code, file paths, or API keys.

Collected	Never Touched
Token counts (in/out)	Prompt/response text
Message & session counts	Project/repo names
Tool call counts	File paths, code, diffs
Model names	API keys, credentials
Timestamps	Working directories

RPG Character System

Built on the AMI (AI Maturity Index) — 4 dimensions that measure how you use AI, not just how much.

          MST (Mastery)
             |
   PRC ──────+────── VRS
             |
          END (Endurance)

Stat	Measures
Mastery	Power-user behavior (tool calls/session, model diversity)
Precision	Output per effort (efficiency)
Versatility	Multi-tool range
Endurance	Consistency (streaks, active days)

Tiers: Bronze → Silver → Gold → Platinum → Diamond

Supported Tools

Tool	Data Source	Parser
Claude Code	~/.claude/stats-cache.json	CLI
Cursor	state.vscdb (SQLite, read-only)	CLI
Gemini CLI	~/.gemini/tmp/*/logs.json	CLI
ChatGPT	Web request counting	Browser Extension
Gemini Web	Web request counting	Browser Extension
Claude Web	Web request counting	Browser Extension

Quick Start

CLI

One-liner install (any OS, recommended — handles Python detection and PATH):

curl -fsSL https://tokenhoggers.ai/install.sh | sh

Homebrew (macOS):

brew install token-hoggers/tap/tokenhoggers

Python users (if you already have Python set up):

pipx install tokenhoggers  # recommended — isolated install
# or
pip install tokenhoggers

Then use it:

tokenhoggers login              # Sign in with Google (opens browser)
tokenhoggers status             # Show what AI tool data we found locally
tokenhoggers sync               # Send counts to the leaderboard
tokenhoggers sync --force       # Re-sync all historical data

Desktop App (macOS)

Menu bar app that shows your stats at a glance.

cd desktop/src-tauri
source ~/.cargo/env
cargo run

Browser Extension

Tracks request counts on ChatGPT, Gemini, and Claude web (never captures content).

cd extension/icons && python generate.py
# Chrome → chrome://extensions → Developer Mode → Load unpacked → select extension/

Architecture

collectors/cli/        Python CLI — parses local AI tool stats
web/                   Frontend (vanilla HTML/JS/CSS) — hosted on Vercel
supabase/              Backend — PostgreSQL, Auth, Edge Functions, Realtime
desktop/               Tauri 2.x macOS menu bar app
extension/             Chrome MV3 browser extension

Tech Stack

• Backend: Supabase (PostgreSQL + Auth + Edge Functions + Realtime)
• Frontend: Vanilla HTML/JS/CSS (Claude Rank-inspired design)
• CLI: Python 3.9+
• Desktop: Rust / Tauri 2.x
• Extension: Chrome MV3

Contributing

PRs welcome! See CONTRIBUTING.md.

License

MIT — see LICENSE.