create-claude-code-lens/README.md

Set up Claude Code analytics hooks with interactive configuration

# Create Claude Code Lens

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

## 🚀 Quick Start

```bash
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

```bash
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:
```bash
npm install codelens-claude-hooks --save-dev
npx codelens-setup
```

## Related Packages

- [codelens-claude-hooks](https://www.npmjs.com/package/codelens-claude-hooks) - The core hooks package

---

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