Create Claude Code Lens

Interactive setup for Claude Code analytics hooks with zero configuration required.

🚀 Quick Start

npm create claude-code-lens@latest

That's it! This single command will:

• ✅ Prompt for your name - Set how you appear in analytics
• ✅ Install hooks automatically - Set up conversation capture
• ✅ Configure everything - No manual setup needed

What This Does

Creates a complete Claude Code Lens setup that automatically captures your Claude conversations for team coordination analytics.

After Setup

Every time you use Claude Code, your conversations are:

• Captured automatically via hooks
• Sent to analytics with your display name
• Used for team insights like collision detection and flow analysis

Example Usage

cd my-project
npm create claude-code-lens@latest

# Interactive prompt:
👤 What name should we use for your analytics? (e.g., Alex, Sam): Sarah

✅ Setup complete!
🎯 Claude conversations will now be logged as "Sarah"
🚀 Start using Claude Code to capture conversations!

What Gets Installed

• .claude/ folder - Hook scripts and configuration
• User config - Stored in ~/.claude-code-logger/config.json
• Python dependencies - Automatically installed (requests)

Team Coordination Features

Your conversations feed into analytics that provide:

• 🟢 Flow Detection - Smooth progress indicators
• 🟡 Collision Detection - Multiple devs on same files
• 🔴 Stuck Detection - Extended debugging sessions
• 📊 Team Insights - Real-time coordination dashboard

Privacy

• Anonymous tracking - Uses generated UUIDs
• Display names only - No personal data collected
• Local configuration - Settings stored on your machine

Requirements

• Node.js 14+
• Python 3 with pip
• Claude Code installed

Troubleshooting

If setup fails, you can run manually:

npm install codelens-claude-hooks --save-dev
npx codelens-setup

Related Packages

• codelens-claude-hooks - The core hooks package

One command setup for team-wide Claude Code analytics! 🔍