Claude Logger 🚀 - For Hardcore Claude Code Users

日本語版 README

💸 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

• GitHub: @daiokawa
• Twitter: @daiokawa
• HendonMob: Koichi Okawa