VibeBro

Your personal analytics dashboard for Claude Code sessions.

One command. Zero setup. Everything stays on your machine.

Quick Start

npx vibebro

Or install it globally:

npm install -g vibebro
vibebro

That's it. Your browser opens automatically with the full dashboard.

What It Does

VibeBro reads your local Claude Code session data and gives you a clean, visual breakdown of how you're using AI to code.

Dashboard

• Session Stats - Messages sent, assistant replies, total tool calls, token consumption
• Model Distribution - See which models you're using, broken down by calls, tokens, or estimated cost
• Tool Usage - Which tools Claude is calling and how often (Read, Edit, Bash, Grep, etc.)
• Context Window Usage - Live context utilization percentage and peak usage across sessions
• Performance KPIs - 10 key metrics at a glance:
  • Efficiency Score and Task Efficiency
  • Probable Cost (estimated from per-model token usage)
  • Tool Failure Rate
  • Sidechain Usage and Sidechain Fail Rate
  • Rewind Rate (conversation and code rewinds)
  • User Rejection Rate
  • Compaction Pressure
  • Empty Result Rate

AI Vibe Analysis

Get AI-powered insights on your prompting style and session dynamics:

• Vibe Gauges - Happiness, Frustration, Prompt Quality, Confidence, Collaboration (scored 1-10)
• Prompting Score - Clarity, Specificity, Context Provided, Task Decomposition
• Communication Style - How directive vs collaborative you are, verbosity, technical depth
• Prompt Evolution - How your prompting quality changed over the session
• Emotional Arc - A visual timeline of your mood throughout the session
• Tips - Actionable advice to improve your prompting
• Notable Patterns - Specific observations referencing your actual messages
• Batch Analysis - Run vibe analysis across all sessions in a project at once, with progress tracking and aggregated task efficiency scores

Task Efficiency

Track how efficiently you're working across sessions:

• Per-session scores - See optimal vs actual turns per task, rework turns, and efficiency percentage
• Project-wide aggregation - Aggregated task efficiency across all analyzed sessions
• Dashboard KPI - Task Efficiency shows up as a KPI card, with one-click analysis for unanalyzed sessions

Changelog

Generate structured changelogs from any session using Claude Haiku:

• Per-session or all-at-once - Generate a changelog for a single session, or batch-generate for every session in a project
• Incremental updates - Watermark tracking means only new messages are processed. No wasted work, no duplicates.
• Markdown rendered - Changelogs display with proper heading, bullet, and code formatting
• Repo copy - Every changelog is also saved to your project's .claude/changelogs/ folder
• Copy for Claude Code - One-click copies a ready-to-paste prompt that tells Claude Code to read the changelog before proceeding. Perfect for resuming context after compaction.
• Copy All - Grab every session's changelog in one click

Chat with VibeBro

Ask follow-up questions about your session. VibeBro has full context of your prompts, the analysis, and your conversation history. It gives specific, actionable answers and references your actual message numbers.

Session Management

Browse all recorded sessions for a project with metadata — first message preview, message count, file size, and last modified date. Delete individual sessions you no longer need.

Context Window Watcher

Monitor your context window usage in real-time:

npx vibebro --watch

Or enable it from the Settings panel in the dashboard. Get desktop notifications at 80% (warning) and 90% (critical) before auto-compaction hits.

Settings

• Session Retention - Control how long Claude Code keeps your session data (3 months, 6 months, or 1 year)
• Context Watcher - Enable/disable the context window monitor from the dashboard

Features

• 100% local. All data stays on your machine. Nothing is stored externally or sent to any server.
• Zero dependencies. No Express, no React, no anything. Just Node.js.
• Per-session or per-project views. Switch between sessions or see aggregated project stats.
• Persistent vibe analysis. Your vibe analysis results persist across page reloads. Chat is ephemeral by design.
• Works with all Claude models. Opus, Sonnet, Haiku - all tracked and broken down individually.
• Cross-platform notifications. macOS, Windows, and Linux desktop notifications for context warnings.
• Clean CLI sessions. VibeBro's internal Claude calls use --no-session-persistence so they never pollute your session history.

Requirements

• Node.js 16+
• Claude Code installed (that's where your session data comes from)

Things to Know

• AI features use your credits. Vibe Analysis, Chat with VibeBro, and Changelog generation consume from your Claude Code subscription or API credits.
• AI may not be perfect. AI-generated insights, cost estimates, and analysis are approximate and may not always be accurate.
• Cost estimates are approximate. The Probable Cost KPI uses standard Anthropic API rates. Subscription plans, prompt caching discounts, and batch pricing are not fully accounted for.
• Changelog uses Haiku. Changelogs are generated with the Haiku model for speed and low cost.

Links

• Follow us: @vibeasaservice

License

MIT