Open-source CLI

Know your
AI coding usage.

Usage insights for Claude Code, Codex, and more.
Not just how much — how to use it smarter.

npx vusage

vusage

╭──────────────────────────────────────────╮
│  VibeUsage — Know your AI coding habits  │
╰──────────────────────────────────────────╯

  Claude Code (last 7 days)
  ├── Sessions  42
  ├── Messages  1,205 user / 1,890 assistant
  ├── Tool calls  3,401
  ├── Tokens  4.2M total (380K in / 3.8M out)
  └── Data scanned  128.5MB

  Top Tools
  ├── Bash          ███████████████ 966
  ├── Read          █████████ 589
  ├── Edit          ███████ 450
  └── Grep          ███ 193

  💡 Insight: 40% of your tool calls are file reads.
     Consider using Grep for targeted searches to save tokens.

Insights, not just data

Other tools tell you how much you spent. VibeUsage tells you how to spend less — with personalized tips based on your actual patterns.

Rate limit awareness

See 5-hour and 7-day windows at a glance. Know exactly when limits reset. Plan your work around your quota.

100% local

All data stays on your machine. No cloud, no telemetry, no accounts. Read-only access to your existing session files.

Multi-tool support

Claude Code today. Codex, Cursor, and Gemini CLI coming soon. One tool for all your AI coding assistants.

Complementary to ccusage

ccusage

"You spent $47.20 last week"

Financial report

VibeUsage

"40% of tokens go to file reads — try Grep"

Usage coach

Both great tools. Use them together — ccusage for cost tracking, VibeUsage for habit optimization.

Get started in 3 seconds