claude-logger

2.0.3 • Public • Published

Claude Logger 🚀 - For Hardcore Claude Code Users

日本語版 README

Claude Logger
npm version npm downloads GitHub stars License

🔥 Track ALL your parallel Claude sessions. Justify that $200/month. 🔥

💸 The Math That Changes Everything

Claude Max ($200/month) - Work harder and reduce your cost virtually

🧮 Revolutionary Cost Calculation:

  • 1 session = $200/month
  • 4 parallel sessions = $50/month per session*
  • 8 parallel sessions = $25/month per session**
  • 16 parallel sessions = $12.50/month per session***
  • 32 parallel sessions = PRACTICALLY FREE!****

* Not actual pricing. You still pay $200/month.
** Still $200/month. But divided by 8 sounds better!
*** Your electricity bill might disagree.
**** CPU has left the chat.

🎯 "The more sessions you run, the cheaper each one becomes!"

(Disclaimer: This is not how money works. But it IS how we justify things to ourselves.)

You're already running multiple Claudes. Now RATIONALIZE IT with MATH!

🔥 What is Claude Logger?

The ULTIMATE productivity tool for power users who run multiple Claude Code sessions simultaneously. Track EVERYTHING. Analyze EVERYTHING. Optimize EVERYTHING.

📊 Every 15 minutes, automatically:

  • Logs all active sessions
  • Tracks token usage
  • Records project progress
  • Prevents log conflicts
  • Creates unified timeline

💪 Built for the 1% of Claude Users

You know who you are:

  • Running 4+ Claude terminals
  • Juggling 10+ projects
  • Burning through millions of tokens
  • Need to justify that $200/month

🖥️ Platform Support

  • ✅ macOS
  • ✅ Linux
  • ✅ Windows (WSL)

🛠️ Installation

Quick Install (Recommended)

npm install -g claude-logger
claude-logger init

This will:

  • Set up automatic logging for all terminals
  • Configure 15-minute interval snapshots
  • Create session tracking directories
  • Add shell integration

Manual Install

npm install -g claude-logger

🚀 Usage

After Installation

  1. Start a new terminal (required for shell integration)

  2. For each Claude session, either:

    claude-logger start  # Then follow the instructions

    OR use the wrapper:

    claude-logged  # Instead of 'claude'
  3. View your logs:

    claude-logger dashboard  # Real-time session view
    claude-logger stats      # Today's statistics
    claude-logger merge      # Merge all session logs

That's it. Now you're tracking EVERYTHING.

📈 What You Can Do With This Data

1. Productivity Analytics

claude-logger stats --this-week
Peak productivity: Tuesday 2-4 PM (8 concurrent sessions)
Token velocity: 2.3M tokens/hour
Sessions completed: 47 projects

2. Project Timeline Visualization

claude-logger timeline --export

Generate beautiful Gantt charts showing all parallel work streams.

3. Parallel Efficiency Reports

claude-logger efficiency --monthly
Total sessions: 847
Parallel efficiency: 4.2x
Average concurrent sessions: 6.3

🎤 PRODUCTIVITY MULTIPLIER 🎤
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Running 4 sessions? 4x the output!
Running 8 sessions? 8x the productivity!!
Running 16 sessions? SUPERHUMAN CODING!!!

BUT WAIT, THERE'S MORE!

Running 32 sessions? YOU ARE THE MATRIX!!!!
※Your computer might explode

*All for the same $200/month. Unlimited tokens.
 The more you run, the more you get done!

4. Token Usage Heatmaps

Find your most productive hours. Optimize your schedule. DOMINATE.

5. Project Success Predictor

ML-powered analysis of your work patterns. Know which projects will succeed before you start.

🎯 Features That Matter

  • Zero Config - Just works
  • File Locking - No conflicts with 100 parallel sessions
  • Session Intelligence - Knows which terminal is doing what
  • 15-Min Snapshots - Perfect granularity for analysis
  • Git-Ready - Version control your productivity
  • Export Everything - CSV, JSON, SQL, whatever you need

💡 Imaginary User Stories

"I run 8 Claude sessions for my startup. This tool showed me I was wasting 3 hours daily on context switching. Fixed it. Revenue up 40%." - Startup Founder

"Tracked 2.1 million tokens across 6 projects. Found my 'golden hours' are 11pm-3am. Now I plan around it." - Solo Developer

"Company thought I was slacking. Showed them my Claude Logger stats. Got promoted." - Senior Engineer

📊 Sample Output

## 2025-05-26 15:00 - System Summary
- Active Sessions: 6
- Total Tokens: 3,247,891
- Projects in Progress: 
  - Terminal 1: E-commerce Platform (87% complete)
    • Added Stripe payment integration
    • Fixed cart calculation bug
    • Implemented order tracking API
  - Terminal 2: ML Pipeline (32% complete)
    • Set up TensorFlow environment
    • Created data preprocessing scripts
    • Training model on sample dataset
  - Terminal 3: iOS App (64% complete)
    • Designed user authentication flow
    • Integrated push notifications
    • Fixed memory leak in image picker
  - Terminal 4: API Documentation (91% complete)
    • Generated OpenAPI specs
    • Added authentication examples
    • Writing rate limiting guide
  - Terminal 5: Database Migration (15% complete)
    • Backed up production data
    • Created migration scripts
    • Testing rollback procedures
  - Terminal 6: Performance Testing (43% complete)
    • Set up k6 load testing
    • Identified N+1 query issues
    • Optimizing database indexes

## Timeline (Last 15 minutes)
14:45 - Terminal 1: Deployed payment integration to staging
14:47 - Terminal 5: Started backing up user_transactions table (2.3GB)
14:48 - Terminal 4: Generated API docs for new endpoints
14:50 - Terminal 2: Model training reached 10k iterations (loss: 0.231)
14:52 - Terminal 3: Fixed critical bug in photo upload feature
14:53 - Terminal 1: Running integration tests for checkout flow
14:55 - Terminal 6: Load test showing 430ms p95 latency
14:57 - Terminal 5: Migration dry-run completed successfully
14:58 - Terminal 2: Saved checkpoint at epoch 15
15:00 - Terminal 4: Published docs to internal wiki

🔮 Coming Soon

  • Claude Logger Pro - Real-time dashboard
  • Team Edition - Track your whole team's Claude usage
  • AI Insights - GPT-4 analysis of your work patterns
  • Slack Integration - Daily productivity summaries
  • VS Code Extension - See stats without leaving editor

🐛 Troubleshooting

Sessions not logging?

  1. Make sure you ran claude-logger init
  2. Restart your terminal after init
  3. Use claude-logger start in each terminal
  4. Check ~/Documents/claude-logs/sessions/ for log files

Logs not merging?

Run manually: claude-logger merge

Need help?

Create an issue: https://github.com/daiokawa/claude-logger/issues

🤝 Join the Movement

This isn't just a logger. It's a heal for ADHDers like us.

Work Smarter. Track Everything. Optimize Relentlessly.


Installation

npm install -g claude-logger
claude-logger init

Start Logging Your Empire

# In each Claude terminal:
claude-logger start

# View real-time stats:
claude-logger dashboard

# Export for analysis:
claude-logger export --format csv

Built by Koichi Okawa

npm version Downloads License: MIT

Package Sidebar

Install

npm i claude-logger

Weekly Downloads

1

Version

2.0.3

License

MIT

Unpacked Size

23.9 kB

Total Files

6

Last publish

Collaborators

  • daiokawa