Skip to content

edwluo/vibeusage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VibeUsage

Know your AI coding habits. Usage insights for Claude Code, Codex, and more.

vibeusage.com · npm

VibeUsage analyzes your local AI coding session data and provides actionable insights — not just how much you've used, but how to use it smarter.

Quick Start

npx vibeusage

No installation required. Works with Node.js 18+.

Commands

vibeusage overview

Shows your AI coding activity summary — sessions, messages, top tools, active projects.

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

  Claude Code (last 7 days)
  ├── Sessions  42
  ├── Messages  1,205 user / 1,890 assistant
  ├── Tool calls  3,401
  └── Data scanned  128.5MB

  Top Tools
  ├── Read          █████████████░░ 892
  ├── Edit          ████████░░░░░░░ 634
  ├── Bash          ██████░░░░░░░░░ 521
  └── Grep          ████░░░░░░░░░░░ 389

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

vibeusage limits

Shows your current rate limit status. Requires Claude Code login.

╭───────────────────────────╮
│  VibeUsage — Rate Limits  │
╰───────────────────────────╯

  5-Hour Window
  ├── Usage  ████████░░░░░░░░░░░░  42%
  └── Resets in  2h 14m

  7-Day Window
  ├── Overall  ██████░░░░░░░░░░░░░░  31%
  ├── Sonnet   ████░░░░░░░░░░░░░░░░  22%
  └── Resets in  143h 39m

  💡 Insight: Plenty of headroom. You're well within limits.

Options

Flag Description Default
-d, --days <n> Number of days to look back 7

How It Works

VibeUsage reads your local AI coding data. Nothing is uploaded or shared.

Data Source Location What It Reads
Claude Code sessions ~/.claude/projects/ JSONL conversation files
Rate limits ~/.claude/.credentials.json OAuth token → Anthropic API
Codex sessions ~/.codex/sessions/ Rollout JSONL files (coming soon)

Privacy

  • 100% local processing — your data never leaves your machine
  • Read-only — VibeUsage never modifies any files
  • No telemetry — zero analytics, zero tracking
  • Open source — audit the code yourself

Roadmap

  • Claude Code session overview
  • Rate limit monitoring
  • Tool usage breakdown (parse content blocks)
  • Codex support
  • Cursor support
  • Usage insights engine (personalized optimization tips)
  • Weekly digest (vibeusage digest)
  • Gemini CLI support

Related

  • ccusage — Excellent tool for retrospective cost analysis. VibeUsage focuses on real-time monitoring and actionable insights.
  • Vibe Island — macOS Notch panel for Claude Code, Codex, Gemini CLI. Real-time status, permission approval, terminal jump. By the same author.

License

MIT

About

Know your AI coding habits. Usage insights for Claude Code, Codex, and more.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors