Open-source CLI for analyzing Claude Code sessions locally and generating productivity reports

Website • Report Bug • Request Feature

What is Vibe-Log?

vibe-log-cli is an open-source command-line tool that analyzes your Claude Code sessions to extract productivity insights and generate reports. All analysis can run completely locally on your machine using Claude Code's capabilities.

Updates

v0.6.0 – Faster, Smoother Reports 🚀 Local reports now run on streamlined templates, cutting Claude runtime by up to 3 minutes and making your reports more reliable than ever.

Architecture

1. 💬 Claude Status Line - Strategic Co-pilot / Advisor (Local)

Strategic product advisor in Claude Code. Your prompts are analyzed locally (via CC) to provide actionable guidance that pushes you to ship faster. Feedback appears in your Claude Code status line with concrete next steps.

2. 📊 Claude Code Productivity Report Generation (Local)

Generate comprehensive productivity reports using Claude Code's sub-agents to analyze your sessions in parallel. No data leaves your machine.

3. 📈 Web Dashboard - Cloud Sync (Optional)

Sync sanitized session data to the Vibe-Log dashboard for web-based analytics and deep insights across sessions and projects.

Status Line - Claude Strategic Co-pilot / Advisor (Safe & Reversible)

The Status Line uses your local Claude Code to provide strategic guidance that pushes you to ship faster. It remembers your original goal and gives concrete, actionable steps to achieve it.

🔒 Installation Safety: Automatically backs up your existing status line configuration. Uninstalling instantly restores your original setup - zero risk to your Claude Code configuration.

Why Use Status Line?

• 🚀 Ship Faster: Get pushed to deliver
• 🎯 Stay Focused: Remembers your original mission and keeps you on track and forward ⏩︎
• ⚡ Concrete Actions: Specific next steps like:
• 📈 Strategic Thinking: Considers edge cases, user experience, and scaling at the right time
• 📊 Token Usage Display: Integrates with ccusage to show real-time token metrics
• ↩️ Easy Restore: Your original status line is backed up and can be restored anytime

How Status Line Works

1. Intercepts prompts submitted in Claude Code
2. Analyzes via the local Claude Code latest prompt with relevant session context.
3. Provides strategic guidance and pushes you to ship
4. Displays actionable feedback in the Claude Code status line

In more details:

flowchart LR
    subgraph Input ["✳️ In Claude Code"]
        User([👤 You type a<br/>prompt]) --> Submit[Press Enter to<br/>submit prompt]
        Submit --> Hook[🪝 UserPromptSubmit<br/>hook triggers]
    end

    subgraph Analysis ["🧠 Local Prompt Analysis via Claude Code SDK"]
        Hook --> CLI[Vibe-log CLI<br/>receives prompt]
        CLI --> Check{Is new chat?}
        Check -->|No| Context[📝 Include previous<br/>conversation]
        Check -->|Yes| Direct[💭 Analyze prompt<br/>standalone]
        
        subgraph Personality ["🎭 Infuse Coach Personality"]
            Gordon[🧑‍🍳 Gordon<br/>Tough love]
            Vibe[💜 Vibe-log<br/>Encouraging]
            Custom[✨ Custom<br/>Your style]
        end
        
        Context --> SDK[Claude SDK<br/>analyzes prompt quality]
        Direct --> SDK
        Personality -.-> SDK
        SDK --> Score[📊 Generate score<br/>& suggestion]
    end

    subgraph Display ["💬 Status Line Feedback"]
        Score --> Save[💾 Save to<br/>~/.vibe-log/analysis]
        Save --> Status[Status bar<br/>reads result]
        Status --> Show[🟢 85/100<br/>✨ Gordon says:<br/>Add more context chef!]
    end

    Show --> Improve([📈 Better prompts<br/>Better results])

Loading

Coach Personalities

• Gordon - Sharp, pushy, business-focused. Creates urgency: "Ship by FRIDAY or you're fired!"
• Vibe-Log - Supportive but pushy senior dev. Helps you ship: "MVP checklist: Auth works ✓ | Ship it!"
• Custom - User-defined personality with strategic focus

Example Output

Setup

1. Run npx vibe-log-cli
2. Select "Configure prompt coach status line"
3. Choose coach personality
4. (Optional) Enable ccusage token metrics display
5. Prompts will be analyzed locally in Claude Code

Note: Installation automatically backs up your current status line (if any). When you uninstall vibe-log, your original configuration is instantly restored.

Local Report Generation Works

Generate comprehensive productivity reports using Claude Code's sub-agents to analyze your sessions in parallel. No data leaves your machine.

• Select timefrema
• Select projects

flowchart TD
    Start([📝 Claude Code Sessions]) --> Select[vibe-log-cli select time frame and projects]
    Select --> Extract[Extracts & prepares session data]
    Extract --> Launch[Launches Claude with instructions]
    Launch --> Parallel{Parallel sub-agents<br/> session analysis}
    Parallel --> Gather[Gathers results &<br/>Generates report]
    Gather --> Output[📊 HTML Report in current folder]    
    style Start fill:#e1f5fe
    style Output fill:#d4edda

Loading

Example of Local Report Output

☁️ Cloud Sync (Optional)

Optionally sync your sanitized session data to the vibe-log dashboard for advanced analytics and tracking over time.

Features

• 🎁 Free Forever: Up to 1,000 session analyses per month
• 📈 Track Over Time: Monitor your prompt quality and productivity trends
• 🔄 Auto-sync: Configure hooks for automatic background sync
• 🔒 Privacy First: All code removed before upload, only patterns synced
• 📊 Web Dashboard: Learn and improve your AI coding sessions.

How It Works

flowchart TD
    subgraph Local ["🏠 Your Machine"]
        Sessions[Claude Code Sessions] --> Select[Select sessions]
        Select --> Privacy[🔒 Privacy Layer<br/>Removes code & secrets<br/>Keeps only patterns]
    end
    
    subgraph Cloud ["☁️ Vibe-Log Cloud"]
        Privacy --> Upload[Upload patterns]
        Upload --> Verify[Server verification]
        Verify --> Analysis[AI analysis]
        Analysis --> Dashboard[📊 Web Dashboard]
    end
    
    subgraph Features ["Dashboard Features"]
        Dashboard --> Track[📈 Track prompt improvement over time]
        Dashboard --> Metrics[⚡ Deeper productivity insights]  
        Dashboard --> Streaks[🔥 Peak times/Low times]
        Dashboard --> Prompt[💬 User Prompt Analysis]
    end
    
    style Local fill:#e1f5fe
    style Cloud fill:#f3e5f5
    style Features fill:#d4edda

Loading

Auto-Sync

What is Auto-Sync

Claude Code Hooks allow Vibe-Log to automatically sync your Claude Code sessions.

What are Claude Code Hooks?

• Small commands that run at specific moments in Claude Code

• They work silently in the background (you won't notice them)

Which hooks do we use?

📍 SessionStart - Syncs previous sessions when you start/resume work (Triggers: startup, resume, clear commands)

📦 PreCompact - Syncs full session before context compression (Triggers: manual or automatic context cleanup)

Why we recommend both:

✓ SessionStart ensures nothing is lost between sessions

✓ PreCompact syncs everything before Claude compresses context

Setup Auto-sync

1. Run npx vibe-log-cli
2. Authenticate with your Github account
3. Enable auto-sync via CLI menu

Supported Coding Engines

Currently supported:

• ✅ Claude Code

Future:

• 🔜 Cursor
• 🔜 VS Code

🌍 Cross-Platform - Runs on macOS, Windows, Linux, and any environment with Node.js

🔒 Privacy & Security

This package is built with complete transparency:

• ✅ Source Code: Fully open source at github.com/vibe-log/vibe-log-cli
• ✅ Not Minified: Published code is readable and verifiable
• ✅ Source Maps: Included for debugging and verification
• ✅ Automated Builds: All releases via GitHub Actions (no manual publishing)
• ✅ npm Provenance: Every package includes build attestation
• ✅ Checksums: SHA256 hashes for integrity verification

Verify Our Package

# Download and inspect the package
npm pack vibe-log-cli@latest
tar -xzf vibe-log-cli-*.tgz
head -100 package/dist/index.js  # Verify it's readable

# Check checksums
cd package/dist && sha256sum -c checksums.sha256

Privacy

• Context-Preserving Sanitization: Messages are sanitized to remove sensitive data while preserving context
• What gets redacted/removed:
  • Code blocks → [CODE_BLOCK_1: javascript]
  • API keys/tokens → [CREDENTIAL_1]
  • File paths → [PATH_1]
  • URLs → [DATABASE_URL], [API_URL]
  • Emails → [EMAIL_1]
  • Environment variables → [ENV_VAR_1]
  • Also Removed: Images/Binary files
• What's preserved: Conversation flow, questions, explanations
• Transparent: Preview sanitized data with the interactive prompt
• Open source: Review our sanitization at src/lib/message-sanitizer-v2.ts

Troubleshooting

Authentication Issues

Try the following:

• Log out from the CLI
• Clear cookies
• Re-authenticate via the CLI

No Sessions Found

• Make sure Claude Code is installed
• Check that you've used Claude Code recently

Sessions Stuck in Analyzing

• Please open a Github issue.

Debug Mode

# Enable debug logging
VIBELOG_DEBUG=1 npx vibe-log-cli send

Contributing

We love your input! We want to make contributing to Vibe-Log CLI as easy and transparent as possible. Please see our Contributing Guide for details.

# Clone the repository
git clone https://github.com/vibe-log/vibe-log-cli.git
cd vibe-log-cli

# Install dependencies
npm install

# Run tests
npm test

# Build the project
npm run build

Check out our open issues for a list of proposed features and known issues.

Community

• GitHub: Star us on GitHub
• Issues: Report bugs and request features in GitHub Issues
• Website: Visit vibe-log.dev

Support

Need help? Here are some ways to get support:

• 🐛 Report bugs in GitHub Issues
• 📧 Email us at support@vibe-log.dev

License

MIT © Vibe-Log - see the LICENSE file for details.

Acknowledgments

Built with love by the Vibe-Log team @mickmicksh, @dannyshmueli

Special thanks to ccusage for providing token usage metrics integration for Claude Code sessions.

Star History