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.

Related MCP server: M3 Memory

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

• Manual Imports

• MCP Integrations

• Open Source Core

Development Checks

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

License

Apache-2.0