Merge branch 'main' into refactor/mcp-to-worker

Resolved conflicts:
- SearchManager.ts: Keep refactored class version (main had old search-server.ts startup code)
- worker-service.cjs, search-server.cjs: Keep our built versions
- package-lock.json: Take main's version

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

CLAUDE.md

@@ -47,6 +47,7 @@ Claude-mem is a Claude Code plugin providing persistent memory across sessions.
 - `CLAUDE_MEM_MODEL` - Model for observations/summaries (default: claude-haiku-4-5)
 - `CLAUDE_MEM_CONTEXT_OBSERVATIONS` - Observations injected at SessionStart (default: 50)
 - `CLAUDE_MEM_WORKER_PORT` - Worker service port (default: 37777)
+- `CLAUDE_MEM_PYTHON_VERSION` - Python version for uvx/chroma-mcp (default: 3.13, avoids onnxruntime compatibility issues with Python 3.14+)
 
 ## File Locations
 

README.md

@@ -317,6 +317,7 @@ See [CHANGELOG.md](CHANGELOG.md) for complete version history.
 - `CLAUDE_MEM_MODEL` - AI model for processing (default: claude-haiku-4-5)
 - `CLAUDE_MEM_WORKER_PORT` - Worker port (default: 37777)
 - `CLAUDE_MEM_DATA_DIR` - Data directory override (dev only)
+- `CLAUDE_MEM_PYTHON_VERSION` - Python version for uvx/chroma-mcp (default: 3.13)
 
 See [Configuration Guide](https://docs.claude-mem.ai/configuration) for details.
 

src/services/sync/ChromaSync.ts

@@ -94,9 +94,13 @@ export class ChromaSync {
     logger.info('CHROMA_SYNC', 'Connecting to Chroma MCP server...', { project: this.project });
 
     try {
+      // Use Python 3.13 by default to avoid onnxruntime compatibility issues with Python 3.14+
+      // See: https://github.com/thedotmack/claude-mem/issues/170 (Python 3.14 incompatibility)
+      const pythonVersion = process.env.CLAUDE_MEM_PYTHON_VERSION || '3.13';
       const transport = new StdioClientTransport({
         command: 'uvx',
         args: [
+          '--python', pythonVersion,
           'chroma-mcp',
           '--client-type', 'persistent',
           '--data-dir', this.VECTOR_DB_DIR