# NPM Package Assets - Claude Code Conversation Search MCP

## Package Description
```json
"description": "MCP server for searching Claude Code conversation history across all projects. Find and resume any discussion instantly."
```

## Enhanced Keywords
```json
"keywords": [
  "mcp",
  "claude",
  "claude-code",
  "search",
  "conversation",
  "history",
  "model-context-protocol",
  "anthropic",
  "chat-history",
  "full-text-search",
  "sqlite",
  "typescript",
  "nodejs",
  "developer-tools",
  "cross-project",
  "conversation-finder",
  "session-search",
  "multi-project",
  "conversation-resume",
  "context-search"
]
```

## README Sections

### Header
```markdown
# Claude Code Conversation Search MCP

Finally, searchable Claude Code conversations across all projects.

```bash
npm install -g claude-code-conversation-search-mcp
```

Query from any session:
```bash
"database migration setup"
"authentication implementation" 
"docker configuration issues"
```

Get project, date, summary, and resume command.
```

### Quick Start
```markdown
## Quick Start

Install and it auto-configures with Claude Code:

```bash
npm install -g claude-code-conversation-search-mcp
```

Test from any Claude Code session:
```bash
"list my projects"
"find recent conversations"
```

Search across all projects while working in any project.
```

### Usage Examples
```markdown
## Usage

```bash
# Search by topic
"how we implemented caching"
"API rate limiting discussion"
"deployment pipeline setup"

# Search by technology
"redis configuration"
"postgres migration scripts"
"nginx reverse proxy"

# Search by problem/solution
"memory leak debugging"
"performance optimization"
"error handling patterns"
```

Each result includes:
- Project name and path
- Conversation date
- Context summary  
- Ready-to-use resume command
```

### Features
```markdown
## Features

- **Cross-project search**: Query conversations from any project while working in any other
- **Instant resume**: Get exact `claude --resume` commands for found conversations
- **Real-time indexing**: New conversations are immediately searchable
- **Natural language queries**: Search like you think, not like a database
- **SQLite FTS**: Fast full-text search across thousands of conversations
- **Zero config**: Works with existing Claude Code setup out of the box
```

### Technical Details
```markdown
## Technical

Built with TypeScript, uses SQLite FTS5 for search, integrates via Model Context Protocol.

**System requirements:**
- Node.js 18+
- Claude Code with MCP support
- macOS, Linux, or Windows

**Performance:**
- Sub-second search across 10k+ conversations
- Real-time indexing with file watching
- Minimal memory footprint (~50MB)

**Storage:**
- SQLite database in `~/.claude/conversation-search/`
- Indexes conversation content, not file contents
- Automatic cleanup of deleted conversations
```

### Configuration
```markdown
## Configuration

Auto-configures on install. Manual setup if needed:

```json
// ~/.claude/claude_desktop_config.json
{
  "mcpServers": {
    "conversation-search": {
      "command": "claude-code-conversation-search",
      "args": []
    }
  }
}
```

Environment variables:
```bash
CONVERSATION_SEARCH_DB_PATH=~/.claude/conversation-search/
CONVERSATION_SEARCH_LOG_LEVEL=info
```
```

## Short Descriptions

### NPM Registry (160 chars max)
```
MCP server for searching Claude Code conversation history across all projects. Find and resume any discussion instantly with natural language queries.
```

### GitHub Description
```
Search your Claude Code conversation history across all projects from any session. Natural language queries return project, date, summary, and resume commands.
```

### One-liner
```
Search and resume Claude Code conversations across all projects from any session.
```