AI coding stats - usage tracking and annual wrapped for Claude Code & Codex
AI coding stats CLI for Claude Code and OpenAI Codex. Track your usage and generate annual "Spotify Wrapped" style summaries.
``bash`
npm install -g vibestatsor run directly
npx vibestats
`bashUsage stats (default)
vibestats # Daily usage table
vibestats --monthly # Monthly aggregation
vibestats --model # Aggregate by model
vibestats --total # Show only totals
CLI Flags
$3
| 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 |$3
| Flag | Description |
|------|-------------|
|
--wrapped | Generate wrapped summary |
| --json | Output raw JSON stats |
| --quiet, -q | Only output the shareable URL |
| --no-short | Disable shortlink generation |$3
| Flag | Description |
|------|-------------|
|
--codex | OpenAI Codex only |
| --combined | Claude + Codex combined |$3
| Flag | Description |
|------|-------------|
|
--init | Create config file |
| --config | Show current config |
| --url | Custom base URL |Config File
`bash
vibestats --init
`Creates
~/.vibestats.json:`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` |- Node.js 18+
- Claude Code or OpenAI Codex CLI usage data
Visit vibestats.wolfai.dev to view your wrapped in the browser.
MIT