vibe-log-cli
Advanced tools
vibe-log-cli is an open-source command-line tool that analyzes your Claude Code sessions to extract productivity insights and generate reports. All analyses can run completely locally on your machine using Claude Code's capabilities. It also encompasses a statusline that help you get more from your sessions.
New: Be prepared in 2-3 minutes for your daily standup meeting!
npx vibe-log-cli@latest
Generate comprehensive productivity reports using Claude Code's sub-agents to analyze your sessions in parallel. No data leaves your machine. See example of locally generated report here: https://vibe-log.dev/example-daily-report
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.
just run: npx vibe-log-cli@latest
Get a personalized standup summary of your recent claude coding activity right from your terminal. Runs 100% locally using your own Claude Code installation The standup feature analyzes your recent sessions and generates a concise summary of:
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
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
🔒 Installation Safety: Automatically backs up your existing status line configuration. Uninstalling instantly restores your original setup - zero risk to your Claude Code configuration.
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])
npx vibe-log-cliNote: Installation automatically backs up your current status line (if any). When you uninstall vibe-log, your original configuration is instantly restored.
Generate comprehensive productivity reports using Claude Code's sub-agents to analyze your sessions in parallel. No data leaves your machine.
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
Optionally sync your sanitized session data to the vibe-log dashboard for advanced analytics and tracking over time.
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
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
npx vibe-log-cliCurrently supported:
Future:
🌍 Cross-Platform - Runs on macOS, Windows, Linux, and any environment with Node.js
This package is built with complete transparency:
# 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
[CODE_BLOCK_1: javascript][CREDENTIAL_1][PATH_1][DATABASE_URL], [API_URL][EMAIL_1][ENV_VAR_1]Try the following:
# Enable debug logging
VIBELOG_DEBUG=1 npx vibe-log-cli send
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.
Need help? Here are some ways to get support:
MIT © Vibe-Log - see the LICENSE file for details.
Built with love by the Vibe-Log team @mickmicksh, @dannyshmueli
Special thanks to ccusage for providing token usage metrics integration for Claude Code sessions.
FAQs
Track your building journey with Vibelog
The npm package vibe-log-cli receives a total of 547 weekly downloads. As such, vibe-log-cli popularity was classified as not popular.
We found that vibe-log-cli demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
A malicious Chrome extension posing as an Ethereum wallet steals seed phrases by encoding them into Sui transactions, enabling full wallet takeover.
Security News
Socket is heading to London! Stop by our booth or schedule a meeting to see what we've been working on.
Security News
OWASP’s 2025 Top 10 introduces Software Supply Chain Failures as a new category, reflecting rising concern over dependency and build system risks.