vibe-usage

Local-first usage analytics for AI coding tools.

• Single binary (Rust), no database required
• Unified stats across Gemini CLI, Claude Code, OpenAI Codex, and Kimi Code
• Dashboard for usage, cost, projects, and activity

Screenshots

Install

brew tap cross-entropy-ai/tap
brew install vibe-usage

Or download pre-built binaries from GitHub Releases.

Build from source: docs/build-from-source.md

Quick Start

vibe-usage                        # sync + open dashboard (auto-finds port, opens browser)
vibe-usage serve                  # same as above
vibe-usage serve -p 8080          # use specific port (falls back to auto if busy)
vibe-usage serve --no-browser     # don't open browser automatically
vibe-usage sync                   # collect local raw files only

Data Directory

Default data directory is ~/.vibe-usage.

If you do not want to use ~/.vibe-usage, choose your own directory.

# per command
vibe-usage sync --data-dir ~/data/vibe

# persistent default
export VIBE_USAGE_DATA_DIR=~/data/vibe

Next Docs

• Advanced sync / remote setup: docs/advanced-usage.md
• Dashboard/API endpoint details: docs/web-dashboard.md
• Build and release notes: docs/release.md
• Data model and internals: docs/architecture.md