Claude Memory for VS Code

Persistent memory for Claude Code with semantic search, now available as a VS Code extension.

Features

🔍 Semantic Search: Search memories by meaning, not just keywords
💾 Persistent Storage: Memories survive VS Code restarts
📝 Easy Management: Add, view, and delete memories from the sidebar
🎯 Auto-Compression: Uses DeepSeek/Kimi API to compress long conversations
🔌 Hybrid Architecture: VS Code extension + Python backend service

Requirements

VS Code 1.74.0 or higher
Python 3.8 or higher
pip packages: chromadb, sentence-transformers, requests

Installation

1. Install the VS Code Extension

Download the .vsix file and install:

code --install-extension claude-memory-1.0.0.vsix

Or install from VS Code:

Open Extensions view (Ctrl+Shift+X)
Click "..." menu → "Install from VSIX"
Select claude-memory-1.0.0.vsix

2. Install Python Dependencies

pip3 install chromadb sentence-transformers requests openai

3. Configure API Key (Optional but Recommended)

# Add to ~/.zshrc or ~/.bashrc
export DEEPSEEK_API_KEY="your-api-key"

Get API key from: https://platform.deepseek.com/

Usage

Open the Explorer sidebar and find "Claude Memory" panel.

Commands

Command	Description
Search Memory	Search memories by keywords
Add Memory	Add new memory from input or selection
View Detail	View full memory details
Insert to Editor	Insert memory content into active editor
Delete Memory	Remove a memory

Keyboard Shortcuts

No default shortcuts. Configure in VS Code keyboard settings.

Configuration

Open VS Code settings (Ctrl+,) and search for "Claude Memory":

Setting	Default	Description
`claudeMemory.servicePort`	8765	Python service port
`claudeMemory.autoStart`	true	Auto-start service on launch
`claudeMemory.apiKey`	""	DeepSeek API Key

Architecture

VS Code Extension (TypeScript)
    │
    │ HTTP API (localhost:8765)
    ▼
Python Service (memory_core.py)
    │
    ├─────── SQLite (metadata)
    │
    └─────── Chroma (vectors)

Development

Build Extension

npm install
npm run compile
npm run package

Start Python Service Manually

python3 python-service/server.py --port 8765

Troubleshooting

Service not starting

Check Python is installed: python3 --version
Check dependencies: pip3 list | grep chromadb
Check port 8765 is not in use: lsof -i :8765

Search not working

First search may be slow (downloading embedding model ~80MB)
Check Python service logs in VS Code Output panel

Extension not loading

Reload VS Code window
Check Developer Tools (Ctrl+Shift+I) for errors

License

MIT

Contributing

Issues and PRs welcome at https://github.com/your-username/vscode-claude-memory

Claude Memory

Dulymm