Obsessive
Stat Tracking
for Claude Code

Track every prompt, tool call, and late-night coding session. Earn badges. Build streaks. Watch your rank climb from Bronze to Obsidian.

Get Started See Features

bashstats.com

bashstats

Obsessive stat tracking for CLI Agents

Gold Diamond 68%

Quick Start:

$ npm install -g bashstats && bashstats init

Or just tell your agent:

> Install bashstats globally with npm (npm install -g bashstats), then run bashstats init to set up the hooks and SQLite database. After init completes, verify it's working by running bashstats stats.

FEATURES

Track Locally. Share Globally.

Stats record locally the moment you run init. Sign in with GitHub to sync, share your profile, and climb the leaderboard.

📊

Hosted Profiles

Sign in with GitHub and get a shareable profile at bashstats.com/u/you with your rank, badges, activity heatmap, and full dashboard.

🏆

124+ Achievements

Earn badges for sessions, streaks, token usage, commits, and late-night coding. Tiered from Bronze to System Anomaly.

🔥

Streaks & Ranks

Daily streaks, session records, and an XP rank system that tracks your progress from Bronze to Obsidian.

🥇

Global Leaderboard

Compete with developers worldwide. Sortable by XP, rank, sessions, streaks, badges, and token usage.

🤖

MCP Integration

Query your rank, achievements, and weekly goals directly inside Claude Code. Just ask "what are my stats?"

🔒

Privacy Controls

Stats are local by default. Choose to share publicly, hide from the leaderboard, or go fully anonymous.

DASHBOARD

Your Stats at a Glance

A rich dashboard with activity heatmaps, session history, agent breakdowns, and weekly goals. View locally or on your hosted profile.

CLI

Stats in Your Terminal

Quick stat summaries, achievement progress, and streak info without leaving your terminal.

Instant stat summary with bashstats stats
Achievement progress bars with tier info
Current and longest streak display
Launch the dashboard with bashstats web
Export all data as JSON for analysis

bashstats

$ bashstats stats

bashstats v0.2.3

Prompts: 2,847 Tools: 12,403 Sessions: 342

Time coded: 186h 23m

Streak: 🔥 14 days (best: 31)

Rank: Gold 17,340 / 25,000 XP

████████████████░░░░░░░░ 68%

38 / 53 badges unlocked

SETUP

Three Commands. You're Live.

Install & Init

npm install -g bashstats && bashstats init. Sets up hooks, database, and the MCP server.

Login

bashstats login opens GitHub OAuth in your browser. Stats sync automatically after every session.

bashstats share uploads your stats and gives you a profile URL to share with the world.

CLI

Simple Commands

Command Description

bashstats init Install hooks and set up database

bashstats stats Quick stat summary in your terminal

bashstats achievements List all badges with progress bars

bashstats streak Show current and longest daily streak

bashstats web Launch the browser dashboard

bashstats login Sign in with GitHub for syncing

bashstats share Upload stats and get your profile URL

bashstats export Export all data as JSON

bashstats uninstall Remove hooks and data

Multi-Agent Support

Claude Code

Gemini CLI

Copilot CLI

OpenCode

Start Tracking Your Stats

Free and open source. Install in one command, sign in with GitHub, and join the leaderboard.

ObsessiveStat Trackingfor Claude Code