{"_id":"@ctxovrflw/memory-ctxovrflw","_rev":"6-fb5df1c27b92f776c5e8b81e8a0a01df","name":"@ctxovrflw/memory-ctxovrflw","dist-tags":{"latest":"0.4.0"},"versions":{"0.1.0":{"name":"@ctxovrflw/memory-ctxovrflw","version":"0.1.0","keywords":["openclaw","openclaw-plugin","memory","ai-memory","ctxovrflw","semantic-search","knowledge-graph"],"author":{"name":"ctxovrflw"},"license":"MIT","_id":"@ctxovrflw/memory-ctxovrflw@0.1.0","maintainers":[{"name":"mabridgland","email":"me@maxbridgland.com"}],"homepage":"https://ctxovrflw.dev","bugs":{"url":"https://github.com/M4cs/ctxovrflw-client/issues"},"dist":{"shasum":"def3b3c557a773a6acb12968dec4aa0ea66efe51","tarball":"https://registry.npmjs.org/@ctxovrflw/memory-ctxovrflw/-/memory-ctxovrflw-0.1.0.tgz","fileCount":4,"integrity":"sha512-qYpKFMG+fW8W2UdU4Lpi40ckxJIGkD5/kjZaICIR5cZgb1Z0i51A/iB5Ch3YzncQGRbRD4AbmsWLjSddZ7D+Tg==","signatures":[{"sig":"MEYCIQCcd6uvUjY9hL5Tj1tsKIx98cWRI/QlqeJIzN5Uy657ZwIhAO9H9lf6OlvxtddIn7pG/d3EzkLZIhzlbJKmDn1sZezp","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35624},"gitHead":"2262a4d3309564b46529c36a0f443d3381f95e6f","_npmUser":{"name":"mabridgland","email":"me@maxbridgland.com"},"openclaw":{"extensions":["./index.ts"]},"repository":{"url":"git+https://github.com/M4cs/ctxovrflw-client.git","type":"git","directory":"ctxovrflw"},"_npmVersion":"10.9.4","description":"ctxovrflw memory plugin for OpenClaw — shared AI memory layer with semantic search, knowledge graph, and cross-tool recall","directories":{},"_nodeVersion":"22.22.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/memory-ctxovrflw_0.1.0_1771355354025_0.6308770775280474","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@ctxovrflw/memory-ctxovrflw","version":"0.1.1","keywords":["openclaw","openclaw-plugin","memory","ai-memory","ctxovrflw","semantic-search","knowledge-graph"],"author":{"name":"ctxovrflw"},"license":"MIT","_id":"@ctxovrflw/memory-ctxovrflw@0.1.1","maintainers":[{"name":"mabridgland","email":"me@maxbridgland.com"}],"homepage":"https://ctxovrflw.dev","bugs":{"url":"https://github.com/M4cs/ctxovrflw-client/issues"},"dist":{"shasum":"7af8f6438c988087fdd99e29275df91c004b2e25","tarball":"https://registry.npmjs.org/@ctxovrflw/memory-ctxovrflw/-/memory-ctxovrflw-0.1.1.tgz","fileCount":4,"integrity":"sha512-a0EPCqAI2ed5P/DYAcVCTM7mueT8omCaPCdPmw4/7LYo5VXTTV3TDRH+ATab+YuZQncENpig3YSJVMeOhGM7lQ==","signatures":[{"sig":"MEQCIB79qRsH9og+0u+KGiXaYcKZR2WmDwspPzK1W8y4hNKpAiARpMhHFZSKYTaM8/okuv3wh4ExikxgUfn8zyfY0GNBvA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ctxovrflw%2fmemory-ctxovrflw@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":35624},"gitHead":"a00c1314722aa27c216c1baaa0125a28d95498cf","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1f8a5eff-604c-4498-879f-f8c89f8f6e26"}},"openclaw":{"extensions":["./index.ts"]},"repository":{"url":"git+https://github.com/M4cs/ctxovrflw-client.git","type":"git","directory":"ctxovrflw"},"_npmVersion":"11.6.2","description":"ctxovrflw memory plugin for OpenClaw — shared AI memory layer with semantic search, knowledge graph, and cross-tool recall","directories":{},"_nodeVersion":"24.13.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/memory-ctxovrflw_0.1.1_1771355594396_0.3310484777180056","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@ctxovrflw/memory-ctxovrflw","version":"0.2.0","keywords":["openclaw","openclaw-plugin","memory","ai-memory","ctxovrflw","semantic-search","knowledge-graph"],"author":{"name":"ctxovrflw"},"license":"MIT","_id":"@ctxovrflw/memory-ctxovrflw@0.2.0","maintainers":[{"name":"mabridgland","email":"me@maxbridgland.com"}],"homepage":"https://ctxovrflw.dev","bugs":{"url":"https://github.com/M4cs/ctxovrflw-client/issues"},"dist":{"shasum":"e14f99cc93ea58e7269b3b19b0a4e69552e5efb4","tarball":"https://registry.npmjs.org/@ctxovrflw/memory-ctxovrflw/-/memory-ctxovrflw-0.2.0.tgz","fileCount":4,"integrity":"sha512-Qt11yWGAyH3TmdbdFMABunFKiSAaC/dUAqG4pHgvrXrogxBPa5umLTIq04NXsM4dCirX8K/YTVqrIBisrRDloQ==","signatures":[{"sig":"MEUCIQC9UHknWxaovYzTI/eurQdlEphQjlogxOtULnzDtRnGkgIgJTFLWFC8sJcIMRh2Zwf8ul+FOhC3I/5ZRrOb0rsMs+c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ctxovrflw%2fmemory-ctxovrflw@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":31148},"gitHead":"fff4b8a6d3632ef01317a6621bbeef1b18b17db0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1f8a5eff-604c-4498-879f-f8c89f8f6e26"}},"openclaw":{"extensions":["./index.ts"]},"repository":{"url":"git+https://github.com/M4cs/ctxovrflw-client.git","type":"git","directory":"ctxovrflw"},"_npmVersion":"11.6.2","description":"ctxovrflw memory plugin for OpenClaw — shared AI memory layer with semantic search, knowledge graph, and cross-tool recall","directories":{},"_nodeVersion":"24.13.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/memory-ctxovrflw_0.2.0_1771355821484_0.39911975970624436","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@ctxovrflw/memory-ctxovrflw","version":"0.2.1","keywords":["openclaw","openclaw-plugin","memory","ai-memory","ctxovrflw","semantic-search","knowledge-graph"],"author":{"name":"ctxovrflw"},"license":"MIT","_id":"@ctxovrflw/memory-ctxovrflw@0.2.1","maintainers":[{"name":"mabridgland","email":"me@maxbridgland.com"}],"homepage":"https://ctxovrflw.dev","bugs":{"url":"https://github.com/M4cs/ctxovrflw-client/issues"},"dist":{"shasum":"cb08f7e9d6465795fee07009ac689f19f1b16c4d","tarball":"https://registry.npmjs.org/@ctxovrflw/memory-ctxovrflw/-/memory-ctxovrflw-0.2.1.tgz","fileCount":4,"integrity":"sha512-kSDWG/4vuuBms2FHLq/Rd5CSpbSD3ksDCYwTDWscIRcA5ONSRLBnxJJ8xTnvdw3zA1Q7YcywM45cxlDqySvEhA==","signatures":[{"sig":"MEYCIQDD2oBMy2Nf7BvIkThv2zbkMX7Rd6GADpvxvVdyVgFvawIhAIjFyn4rk/AFeJ1Tms5SLErRSYppzW5AOibrry8+wq30","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ctxovrflw%2fmemory-ctxovrflw@0.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":30929},"gitHead":"8e5e8e4eb0a923b8e20799132ea9ee8aeb958510","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1f8a5eff-604c-4498-879f-f8c89f8f6e26"}},"openclaw":{"extensions":["./index.ts"]},"repository":{"url":"git+https://github.com/M4cs/ctxovrflw-client.git","type":"git","directory":"ctxovrflw"},"_npmVersion":"11.6.2","description":"ctxovrflw memory plugin for OpenClaw — shared AI memory layer with semantic search, knowledge graph, and cross-tool recall","directories":{},"_nodeVersion":"24.13.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/memory-ctxovrflw_0.2.1_1771357046521_0.26610281901159416","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@ctxovrflw/memory-ctxovrflw","version":"0.3.0","keywords":["openclaw","openclaw-plugin","memory","ai-memory","ctxovrflw","semantic-search","knowledge-graph"],"author":{"name":"ctxovrflw"},"license":"MIT","_id":"@ctxovrflw/memory-ctxovrflw@0.3.0","maintainers":[{"name":"mabridgland","email":"me@maxbridgland.com"}],"homepage":"https://ctxovrflw.dev","bugs":{"url":"https://github.com/M4cs/ctxovrflw-client/issues"},"dist":{"shasum":"02fd90d4ae37f020fc95948bcadf03e05c2cd29d","tarball":"https://registry.npmjs.org/@ctxovrflw/memory-ctxovrflw/-/memory-ctxovrflw-0.3.0.tgz","fileCount":7,"integrity":"sha512-3C1Z/ZDG1pmKny39DTfKpcFiYejfxM7y50j0d4UmFtiRsOZoJRnI1vM3VEXMWqMf/9OZwIzwk79jrU6mswqXSw==","signatures":[{"sig":"MEYCIQCn2m57EmofVzEglANOHYFDVXCjbYzSTD0jdsfDuEcWYgIhAOQV/0K2OmKTBRKcOUS3a32DRsgWOC406ygkhkLWPGJu","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ctxovrflw%2fmemory-ctxovrflw@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":46829},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"2dc185f17aa8629af87c1596e5b3751ef20ec4fb","scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1f8a5eff-604c-4498-879f-f8c89f8f6e26"}},"openclaw":{"extensions":["./dist/index.js"]},"repository":{"url":"git+https://github.com/M4cs/ctxovrflw-client.git","type":"git","directory":"ctxovrflw"},"_npmVersion":"11.6.2","description":"ctxovrflw memory plugin for OpenClaw — shared AI memory layer with semantic search, knowledge graph, and cross-tool recall","directories":{},"_nodeVersion":"24.13.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"openclaw":"*","typescript":"^5.7.0"},"peerDependencies":{"openclaw":">=2026.1.0"},"_npmOperationalInternal":{"tmp":"tmp/memory-ctxovrflw_0.3.0_1771362135090_0.5929886447592967","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@ctxovrflw/memory-ctxovrflw","version":"0.4.0","description":"ctxovrflw memory plugin for OpenClaw — shared AI memory layer with semantic search, knowledge graph, and cross-tool recall","license":"MIT","author":{"name":"ctxovrflw"},"homepage":"https://ctxovrflw.dev","repository":{"type":"git","url":"git+https://github.com/M4cs/ctxovrflw-client.git","directory":"ctxovrflw"},"type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"keywords":["openclaw","openclaw-plugin","memory","ai-memory","ctxovrflw","semantic-search","knowledge-graph"],"scripts":{"build":"tsc","typecheck":"tsc --noEmit","clean":"rm -rf dist","prepublishOnly":"npm run build"},"peerDependencies":{"openclaw":">=2026.1.0"},"devDependencies":{"openclaw":"*","typescript":"^5.7.0"},"openclaw":{"extensions":["./dist/index.js"]},"publishConfig":{"access":"public"},"gitHead":"2a6bb58012e0d9421c3483bc03c6fa733d796cd3","_id":"@ctxovrflw/memory-ctxovrflw@0.4.0","bugs":{"url":"https://github.com/M4cs/ctxovrflw-client/issues"},"_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-y7zLg2i4+O6X3NBTTeMvkstkJsGNKIdnvsgwxGaWJB9akDRmWkbA1gvUJpO443z2N1aPVLsIrSeEjLVu4RP1Wg==","shasum":"cafbd5a46b81299398e6db8be40b5e79833fe92d","tarball":"https://registry.npmjs.org/@ctxovrflw/memory-ctxovrflw/-/memory-ctxovrflw-0.4.0.tgz","fileCount":7,"unpackedSize":47240,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ctxovrflw%2fmemory-ctxovrflw@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCsHYZ/Dr4t2ILT81w/R2wj9Y2EqGsaV7ebqSPEiP9JrAIgboMJpSyTN8F9cfjLOehsicn3S+jmzmE26cVIOeaJs6A="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1f8a5eff-604c-4498-879f-f8c89f8f6e26"}},"directories":{},"maintainers":[{"name":"mabridgland","email":"me@maxbridgland.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/memory-ctxovrflw_0.4.0_1771367494497_0.9594148062950238"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-17T19:09:13.659Z","modified":"2026-02-17T22:31:35.026Z","0.1.0":"2026-02-17T19:09:14.177Z","0.1.1":"2026-02-17T19:13:14.569Z","0.2.0":"2026-02-17T19:17:01.637Z","0.2.1":"2026-02-17T19:37:26.675Z","0.3.0":"2026-02-17T21:02:15.242Z","0.4.0":"2026-02-17T22:31:34.647Z"},"bugs":{"url":"https://github.com/M4cs/ctxovrflw-client/issues"},"author":{"name":"ctxovrflw"},"license":"MIT","homepage":"https://ctxovrflw.dev","keywords":["openclaw","openclaw-plugin","memory","ai-memory","ctxovrflw","semantic-search","knowledge-graph"],"repository":{"type":"git","url":"git+https://github.com/M4cs/ctxovrflw-client.git","directory":"ctxovrflw"},"description":"ctxovrflw memory plugin for OpenClaw — shared AI memory layer with semantic search, knowledge graph, and cross-tool recall","maintainers":[{"name":"mabridgland","email":"me@maxbridgland.com"}],"readme":"# ctxovrflw Memory Plugin for OpenClaw\n\nReplace OpenClaw's built-in memory with **ctxovrflw** — a local-first, privacy-focused AI memory layer with semantic search, knowledge graph, and cross-tool recall.\n\n## What It Does\n\n- **Replaces `memory_search` / `memory_get`** with ctxovrflw's semantic search (hybrid keyword + vector)\n- **Adds `memory_store`** to persist important context across sessions\n- **Auto-recall**: Automatically injects relevant memories into agent context before each turn\n- **Auto-capture**: Optionally stores important user messages as memories\n- **Knowledge graph**: Graph-boosted recall surfaces related entities and connections\n- **Cross-tool**: Memories stored by Cursor, Claude Code, Cline, or any MCP-connected tool are available in OpenClaw\n- **`/ctxovrflw` command**: Quick status check without invoking the LLM\n\n## Prerequisites\n\n1. **Install ctxovrflw**: `curl -fsSL https://ctxovrflw.dev/install.sh | bash`\n2. **Run init**: `ctxovrflw init`\n3. **Start daemon**: `ctxovrflw start`\n\n## Install\n\n```bash\nopenclaw plugins install @ctxovrflw/memory-ctxovrflw\n```\n\n> **Tip:** `ctxovrflw init` detects OpenClaw automatically and offers to install the plugin, skill, and agent rules for you via an interactive TUI.\n\n## Configure\n\nAdd to your OpenClaw config:\n\n```json5\n{\n  plugins: {\n    slots: {\n      memory: \"memory-ctxovrflw\"  // Replace built-in memory\n    },\n    entries: {\n      \"memory-ctxovrflw\": {\n        enabled: true,\n        config: {\n          authToken: \"<from ~/.ctxovrflw/config.toml>\",\n          // Optional:\n          daemonUrl: \"http://127.0.0.1:7437\",  // default\n          agentId: \"openclaw\",                   // default\n          autoRecall: true,                      // default\n          autoCapture: false,                    // default\n          recallLimit: 5,                        // default\n          recallMinScore: 0.3,                   // default\n          captureMaxChars: 500,                  // default\n        }\n      }\n    }\n  }\n}\n```\n\nThen restart the gateway:\n\n```bash\nopenclaw gateway restart\n```\n\n## How It Works\n\n### Auto-Recall (default: on)\n\nBefore each agent turn, the plugin searches ctxovrflw for memories relevant to the user's message and injects them as context. The agent sees these automatically — no tool call needed.\n\n### Auto-Capture (default: off)\n\nAfter each agent turn, the plugin scans user messages for important content (preferences, decisions, facts) and stores them automatically. Enable with `autoCapture: true`.\n\n### Tool-Based Access\n\nThe agent can also use tools explicitly:\n\n- `memory_search` — Semantic search with optional subject filter\n- `memory_store` — Store new memories with type, tags, subject\n- `memory_forget` — Delete a memory by ID\n- `memory_status` — Check daemon status, memory count, tier\n\n### CLI\n\n```bash\nopenclaw memory status    # Daemon status\nopenclaw memory search \"deployment preferences\"\nopenclaw memory store \"Max prefers Railway\" --type preference\nopenclaw memory subjects  # List all subjects\n```\n\n## vs Built-in Memory\n\n| Feature | memory-core | memory-lancedb | memory-ctxovrflw |\n|---|---|---|---|\n| Storage | Markdown files | LanceDB + OpenAI | SQLite + local ONNX |\n| Embeddings | None | OpenAI API ($) | Local ONNX (free) |\n| Privacy | Files on disk | API calls to OpenAI | Everything local |\n| Cross-tool | No | No | Yes (MCP server) |\n| Knowledge graph | No | No | Yes (Pro) |\n| Hybrid search | No | Vector only | Semantic + keyword |\n| Auto-recall | No | Yes | Yes |\n| Auto-capture | No | Yes | Yes |\n| Cloud sync | No | No | Yes (E2E encrypted) |\n\n## License\n\nMIT\n","readmeFilename":"README.md"}