cc-insights

# Claude Code Insights

Unlock the hidden value in your Claude Code conversation history through automatic processing, semantic search, and intelligent insight generation.

## Overview

This skill automatically analyzes your project's Claude Code conversations (stored in `~/.claude/projects/[project]/*.jsonl`) to provide:

- **RAG-Powered Semantic Search**: Find conversations by meaning, not just keywords
- **Automatic Insight Reports**: Pattern detection, file hotspots, tool usage analytics
- **Activity Trends**: Understand your development patterns over time
- **Knowledge Extraction**: Surface recurring topics, solutions, and best practices
- **Zero Manual Effort**: Fully automatic processing of existing conversations

## When to Use This Skill

**Trigger Phrases**:
- "Find conversations about [topic]"
- "Generate weekly insights report"
- "What files do I modify most often?"
- "Launch the insights dashboard"
- "Export insights as [format]"

**Use Cases**:
- Search past conversations by topic or file
- Generate activity reports and insights
- Understand development patterns over time
- Extract knowledge and recurring solutions
- Visualize activity with interactive dashboard

**NOT for**:
- Real-time conversation analysis (analyzes history only)
- Conversations from other projects (project-specific)
- Manual conversation logging (automatic only)

## Response Style

**Informative and Visual**: Present search results with relevance scores and snippets. Generate reports with clear metrics and ASCII visualizations. Offer to save or export results.

## Mode Selection

| User Request | Mode | Reference |
|--------------|------|-----------|
| "Find conversations about X" | Search | `modes/mode-1-search.md` |
| "Generate insights report" | Insights | `modes/mode-2-insights.md` |
| "Launch dashboard" | Dashboard | `modes/mode-3-dashboard.md` |
| "Export as JSON/CSV/HTML" | Export | `modes/mode-4-export.md` |

## Mode Overview

### Mode 1: Search Conversations
Find past conv