vibe-log-cli

Improved Onboarding Experience 🚀

Getting started with vibe-log is now smoother than ever: Better first-run setup flow Helpful prompts to guide you through configuration Improved error messages when things go wrong

Improved Time Calculation ⏱️

More accurate session duration tracking with better handling of: Massive sessions: Sessions with 10,000+ messages no longer cause performance issues Smart truncation: Large sessions are intelligently truncated while preserving time data Consistent timestamps: Better parsing and validation of session timing information Edge case handling: Fixed issues with sessions that had missing or invalid timestamps

💬 More about Claude Status Line - Strategic Co-pilot / Advisor (Local)

🔒 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

Architecture

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])

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

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]