vibestats

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

Installation

``bash
npm install -g vibestats


or run directly


npx vibestats
`

Usage

`bash


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

$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` |

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