enhanced-memory-mcp: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Overview

Enhanced Memory MCP Server - persistent, compressed, searchable memory for AI agents. SQLite storage behind a single-owner Unix-socket daemon, 4-tier architecture, Git-like versioning, and layered RAG retrieval. 206 tools listed over stdio from the repo venv with the optional backends installed (measured 2026-08-26 at 141e00f, identical under the default and full ENHANCED_MEMORY_SURFACE: the surface stamps front-door _meta, it does not change registration). 192 tools with only requirements.txt installed (fresh Python 3.12 venv, same day, same commit; the re-ranking, hybrid/NMF and OmniMEM groups log a skip reason). Any tool-count claim without its environment stated is underspecified.

Figures in this file were measured at commit 99dc95e; re-measure before citing them elsewhere.

Build & Test Commands

setup/setup.sh                      # venv, deps, .env, database dir (idempotent)
setup/bin/memory-db-daemon.sh &     # the daemon; nothing works without it
./healthcheck.sh                    # post-install gate: real write/read/cleanup round trip

# Functional suite (needs the daemon). Judge it by EXIT CODE, not pass count:
# with no ENHANCED_MEMORY_*/MEMORY_DB_* vars set it builds its own sandbox and
# runs everything; with them set it runs operator-directed and skips the checks
# that describe a sandbox it did not create. Measured on one machine at one
# commit: 106 isolated / 102 operator-directed, both exit 0. The run prints its
# own mode and names what it skipped.
python3 comprehensive_test.py

# Developer suite (needs: pip install -r dev-requirements.txt).
# 164 passed at 99dc95e.
python -m pytest tests/

# RAG integration suite - registration and class-level, no daemon needed.
# 22/22 at 99dc95e, verified under an isolated ENHANCED_MEMORY_DIR.
python3 test_rag_integration_comprehensive.py

Store-safety warning: test_agi_phase2.py, test_agi_phase3.py, and test_agi_phase4.py operate on whatever database the environment resolves - on a configured machine that is the REAL store. Run them only with ENHANCED_MEMORY_DIR pointed at a scratch directory. (The pytest suite under tests/ is isolated by its conftest; these standalone scripts are not.)