NeuraKeep

Auditable, source-cited memory infrastructure for AI agents with conflict detection, proposal review, and reusable failure memory.

GitHub

Documentation

NeuraKeep

NeuraKeep is a local-first memory system for AI agents.

It gives Claude Desktop, Claude Code, Codex, OpenClaw, Cursor-style tools, and other MCP clients a shared, source-cited memory layer that runs on your own machine.

What It Does

  • Imports Markdown, text, JSONL, and PDFs into a local vault
  • Preserves raw sources and extracts cited memory proposals
  • Lets you review memory before it becomes durable
  • Searches across sources, facts, events, failures, and decisions
  • Shows a graph of related memory with progressive expansion
  • Exposes MCP tools for agents:
    • memory_search
    • memory_read
    • memory_explain_sources
    • memory_propose_update
    • memory_apply_update

The core rule is simple: agents can propose memory, but durable memory should be reviewable and source-cited.

Local Install

Requirements:

  • Node.js 20+
  • npm

Install the published CLI:

npm install -g neurakeep
neurakeep init --root .umos
neurakeep mcp --root .umos

npm install
npm run build:all
node dist/cli/index.js init --root .umos
node dist/cli/index.js serve --root .umos --host 127.0.0.1 --port 8765 --ui --read-write

Open:

http://127.0.0.1:8765/index.html

CLI Examples

node dist/cli/index.js ingest README.md --root .umos --kind markdown --space personal --trust-level trusted --origin manual --sensitivity internal
node dist/cli/index.js search "what should my agents remember?" --root .umos --space personal --neighbors 1
node dist/cli/index.js propose latest --root .umos
node dist/cli/index.js apply <proposal-id> --root .umos
node dist/cli/index.js mcp --root .umos

Local MCP Setup

Example stdio MCP config:

{
  "command": "node",
  "args": [
    "C:/path/to/neurakeep/dist/cli/index.js",
    "mcp",
    "--root",
    "C:/path/to/neurakeep/.umos"
  ]
}

Local HTTP mode:

node dist/cli/index.js serve --root .umos --host 127.0.0.1 --port 8765 --ui

Use --token or NEURAKEEP_MCP_TOKEN before exposing any HTTP endpoint outside your machine.

Open Source Scope

This repository is the local, self-managed NeuraKeep core: CLI, local vault, local UI, local MCP, imports, search, graph, proposal review, and memory quality tools.

Docs

Development Checks

npm run typecheck
npm run build:all
npm test
npm run e2e

License

Apache-2.0