claude-memory

Claude Memory

Index and search Claude Code conversation history with semantic search.

Features

• Semantic Search - Query conversations by meaning, not just keywords
• Claude Code Plugin - Integrate directly with Claude Code
• Local Processing - Uses local embedding models (no external API calls)
• Fact Discovery - Claude naturally discovers and saves facts during conversation

Installation

# Clone and install
git clone https://github.com/kamrul1157024/claude-memory.git
cd claude-memory
pip install -e .

# Download embedding model
claude-memory models download

# Initialize and index
claude-memory init
claude-memory index

Usage

# Search conversations
claude-memory search "what async patterns do I use"

# Index new conversations
claude-memory index

# View stats
claude-memory stats

# Show specific conversation
claude-memory show <conversation-id>

Claude Code Plugin

Install claude-memory as a Claude Code plugin to search your conversation history.

Install from Marketplace

# Add the marketplace
/plugin marketplace add kamrul1157024/claude-memory

# Install the plugin
/plugin install claude-memory

Manual Installation

Copy the skill directory to your Claude skills folder:

cp -r skills/claude-memory ~/.claude/skills/

Or create a symlink:

ln -s $(pwd)/skills/claude-memory ~/.claude/skills/claude-memory

Using the Plugin

In Claude Code, you can now ask:

• "Search my conversations for React hooks"
• "Find previous discussions about authentication"
• "Look up how I solved the caching problem"

Claude will automatically invoke the skill and search your indexed conversation history.

Fact Discovery

Claude will naturally discover facts about you during conversations (technologies you use, preferences, patterns). When it discovers useful facts, it will ask for your confirmation before saving them to ~/.claude/CLAUDE.md.

Build Binary

# macOS native build
make build-macos
make install

# Linux via Docker
make build-docker

Configuration

Config is stored at ~/.claude-memory/config.yaml:

active_models:
  embedding: nomic-embed-text-v1.5

Change the embedding model:

claude-memory config set active_models.embedding bge-small-en-v1.5
claude-memory models download bge-small-en-v1.5
claude-memory index --full  # Re-index with new model

License

MIT