memaxx-memory-local

Self-hosted persistent memory for AI coding tools. Runs 100% on your machine with SQLite — bring your own API key.

Setup

npx memaxx-memory-local --setup

This runs an interactive wizard to configure your embedding provider (OpenRouter, OpenAI, or Ollama).

MCP Config

{
  "mcpServers": {
    "memaxx-memory": {
      "command": "npx",
      "args": ["memaxx-memory-local"]
    }
  }
}

Features

• 28 MCP tools — memory, knowledge graph, thinking, tasks, postmortems, smart context, migration
• Hybrid search — semantic (sqlite-vec) + full-text (FTS5) + keyword with time-decay ranking
• Knowledge graph — LLM-based entity extraction, graph traversal, temporal queries
• Multi-provider embeddings — OpenAI, OpenRouter, Ollama (nomic-embed-text, mxbai-embed-large, all-minilm)
• Zero cloud dependency — everything stored locally in SQLite
• Single-file backup — just copy ~/.memaxx/memory.db

Commands

npx memaxx-memory-local           # Start MCP server
npx memaxx-memory-local --setup   # Run/re-run setup wizard
npx memaxx-memory-local --backup  # Backup database
npx memaxx-memory-local --version # Show version

Requirements

• Node.js 20+
• An API key for embeddings (OpenRouter, OpenAI, or Ollama running locally)

License

Proprietary. See LICENSE file.