vibestats

AI coding stats CLI for Claude Code and OpenAI Codex. Track your usage and generate annual "Spotify Wrapped" style summaries.

Installation

npm install -g vibestats
# or run directly
npx vibestats

Usage

# Usage stats (default)
vibestats              # Daily usage table
vibestats --monthly    # Monthly aggregation
vibestats --model      # Aggregate by model
vibestats --total      # Show only totals

# Wrapped summary
vibestats --wrapped    # Annual wrapped summary

CLI Flags

Usage Mode (default)

| Flag | Description | |------|-------------| | --monthly | Aggregate by month | | --model | Aggregate by model | | --total | Show only totals | | --since YYYY-MM-DD | Filter from date | | --until YYYY-MM-DD | Filter to date | | --compact, -c | Compact table (hide cache columns) | | --json | Output raw JSON |

Wrapped Mode

| Flag | Description | |------|-------------| | --wrapped | Generate wrapped summary | | --json | Output raw JSON stats | | --quiet, -q | Only output the shareable URL | | --no-short | Disable shortlink generation |

Data Source

| Flag | Description | |------|-------------| | --codex | OpenAI Codex only | | --combined | Claude + Codex combined |

Config

| Flag | Description | |------|-------------| | --init | Create config file | | --config | Show current config | | --url <url> | Custom base URL |

Config File

vibestats --init

Creates ~/.vibestats.json:

{
  "baseUrl": "https://vibestats.wolfai.dev",
  "outputFormat": "normal",
  "theme": { "enabled": true },
  "hideCost": false
}

Data Sources

| Source | Location | |--------|----------| | Claude Code | ~/.claude/projects/**/*.jsonl | | OpenAI Codex | ~/.codex/sessions/*.jsonl |

Requirements

• Node.js 18+
• Claude Code or OpenAI Codex CLI usage data

View Online

Visit vibestats.wolfai.dev to view your wrapped in the browser.

License

MIT