{
  "markdown": "# NeuraKeep\n\nNeuraKeep is a local-first memory system for AI agents.\n\nIt gives Claude Desktop, Claude Code, Codex, OpenClaw, Cursor-style tools, and other MCP clients\na shared, source-cited memory layer that runs on your own machine.\n\n## What It Does\n\n- Imports Markdown, text, JSONL, and PDFs into a local vault\n- Preserves raw sources and extracts cited memory proposals\n- Lets you review memory before it becomes durable\n- Searches across sources, facts, events, failures, and decisions\n- Shows a graph of related memory with progressive expansion\n- Exposes MCP tools for agents:\n  - `memory_search`\n  - `memory_read`\n  - `memory_explain_sources`\n  - `memory_propose_update`\n  - `memory_apply_update`\n\nThe core rule is simple: agents can propose memory, but durable memory should be reviewable and\nsource-cited.\n\n## Local Install\n\nRequirements:\n\n- Node.js 20+\n- npm\n\n```bash\nnpm install\nnpm run build:all\nnode dist/cli/index.js init --root .umos\nnode dist/cli/index.js serve --root .umos --host 127.0.0.1 --port 8765 --ui --read-write\n```\n\nOpen:\n\n```text\nhttp://127.0.0.1:8765/index.html\n```\n\n## Start Free Locally\n\nUse the local core when you want private, source-cited memory on your own machine:\n\n- import Markdown, text, JSONL, or PDFs\n- review extraction proposals before durable memory is applied\n- connect Claude, Codex, OpenClaw, or another MCP client over stdio\n\n## Hosted NeuraKeep\n\nUse the hosted app when you need Google or enterprise SAML/OIDC sign-in, private personal vaults,\nisolated shared Team spaces, remote MCP over HTTPS, managed storage, backups, and Stripe-managed\nbilling. Team workspaces include owner/admin/reviewer/editor/viewer roles, email-bound invitations,\naudit history, licensed seats, and SCIM provisioning. Hosted access requires an active individual or\nTeam subscription; space-bound service tokens remain available for controlled MCP clients.\n\nThe public package contains the complete local-first core. Managed authentication, Stripe billing,\nTeam tenancy, SSO, SCIM, deployment automation, and production credentials remain part of the\nhosted service and are not required to run NeuraKeep locally.\n\n## CLI Examples\n\n```bash\nnode dist/cli/index.js ingest README.md --root .umos --kind markdown --space personal --trust-level trusted --origin manual --sensitivity internal\nnode dist/cli/index.js search \"what should my agents remember?\" --root .umos --space personal --neighbors 1\nnode dist/cli/index.js propose latest --root .umos\nnode dist/cli/index.js apply <proposal-id> --root .umos\nnode dist/cli/index.js mcp --root .umos\n```\n\n## Local MCP Setup\n\nExample stdio MCP config:\n\n```json\n{\n  \"command\": \"node\",\n  \"args\": [\n    \"C:/path/to/neurakeep/dist/cli/index.js\",\n    \"mcp\",\n    \"--root\",\n    \"C:/path/to/neurakeep/.umos\"\n  ]\n}\n```\n\nLocal HTTP mode:\n\n```bash\nnode dist/cli/index.js serve --root .umos --host 127.0.0.1 --port 8765 --ui\n```\n\nUse `--token` or `NEURAKEEP_MCP_TOKEN` before exposing any HTTP endpoint outside your machine.\n\n## Free vs Paid\n\nThe open-source version is for local, self-managed memory. The hosted product adds managed auth,\nteam spaces, remote connectors, shared storage, backups, and administration. See\n[NeuraKeep pricing](https://www.neurakeep.com/#pricing) for the current hosted plans.\n\n## Docs\n\n- [Manual Imports](docs/MANUAL_IMPORTS.md)\n- [MCP Integrations](docs/MCP_INTEGRATIONS.md)\n- [Open Source Core](docs/OPEN_SOURCE.md)\n\n## Development Checks\n\n```bash\nnpm run typecheck\nnpm run build:all\nnpm test\nnpm run e2e\nnpm run check:secrets\n```\n\n## License\n\nApache-2.0\n",
  "bytes": 3542,
  "sha": "c6980b9e424b3546d15f8003fe4300eabd1a9b3f74098b1d760bfc842ac2bfef",
  "repo_slug": "dominiclachance/neurakeep",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dominiclachance_neurakeep_83aea821/readme"
}