Agent Memory (agent-memory-mcp v3.1)

agent-memory-mcp provides persistent, ACID-safe, full-text searchable memory for AI coding agents. Backed by Node 22.5+/24+ native node:sqlite (WAL + FTS5), it features per-project databases, a centralized cross-project global knowledge graph, a two-tier anti-loop dead-end registry, and token budgeting middleware.

Storage Architecture

• Per-Project Live Stores: ~/.ag-memory-mcp/stores/<project-slug>-<hash>.db (keeps repository trees 100% clean).
• Central Global Knowledge Graph: ~/.ag-memory-mcp/global.db (cross-project patterns, library quirks, and token audit logs).
• Configuration: ~/.ag-memory-mcp/config.json (or AG_MEMORY_MAX_RESPONSE_TOKENS environment variable).
• Zero-Loss JIT Migration: Automatically detects, verifies, and archives legacy <project_path>/.ag-memory.json (v2.0) to ~/.ag-memory-mcp/backups/.

Tool Quick Reference (15 Tools)

Project-Scoped Memory Tools (1–10)

Global Knowledge & Taxonomy Tools (11–15)

Canonical Bootstrap Pattern (Single Atomic Call)

When initializing a new project workspace, save all 3 core architectural nodes in one atomic transaction:

{
  "project_path": "C:/Projects/MyApp",
  "entries": [
    {
      "slug": "tech-stack",
      "title": "Tech Stack & Ecosystem",
      "category": "architecture",
      "tags": ["architecture", "stack"],
      "summary": "..."
    },
    {
      "slug": "project-structure",
      "title": "Project Structure & Architecture",
      "category": "architecture",
      "tags": ["architecture", "structure"],
      "files": ["src/index.ts"],
      "summary": "..."
    },
    {
      "slug": "build-run",
      "title": "Build & Run Instructions",
      "category": "architecture",
      "tags": ["architecture", "build"],
      "files": ["package.json"],
      "summary": "..."
    }
  ]
}