Agent Genesis

Agent Genesis

🔍 **Semantic search across your Claude Code conversation history**

Agent Genesis indexes and searches your Claude Code and Claude.ai/Desktop conversations, making it easy to find past discussions, decisions, and solutions.

🔒 **Privacy First**: Runs 100% locally. No API keys required. Your conversations never leave your machine.

---

What Does It Do?

Ask questions like:

• "Find my conversations about authentication"
• "When did I discuss database optimization?"
• "What was that solution for the API rate limiting issue?"

Agent Genesis finds relevant conversations using **semantic search** (meaning-based, not just keyword matching).

---

Table of Contents

• Prerequisites
• Quick Start
• Stopping the Service
• Importing Claude.ai Data
• Searching Your Conversations
• MCP Integration
• Troubleshooting
• How It Compares
• Configuration Reference
• Contributing

---

Prerequisites

Before you start, you need:

• Docker (version 20.10+) - Install Docker
• 6GB+ RAM available for Docker (required for the local embedding model)
• Claude Code conversations in your projects folder (created automatically when you use Claude Code)

**Verify Docker is installed:**

docker --version
# Should output: Docker version 20.10.x or higher

**Find your Claude Code projects path:**

OS	Path
Linux	~/.claude/projects/
macOS	~/.claude/projects/
Windows	C:\Users\YourName\.claude\projects\
Windows (WSL)	/home/youruser/.claude/projects/

---

Quick Start

Step 1: Clone the Repository

git clone https://github.com/Platano78/agent-genesis.git
cd agent-genesis

Step 2: Create Yo