opencode-codex-memory 0.2.0 → 0.2.1

package/README.md

@@ -52,8 +52,8 @@ anything.
    immediately (codex ships the same system behind a default-off feature flag
    with a consent prompt; a standalone memory plugin *is* the consent).
 
-Requires only opencode (official release). Git is bundled (`isomorphic-git`) —
-no `git` binary or any other external tool needed.
+Requires opencode 1.18 or newer (official release). Git is bundled
+(`isomorphic-git`) — no `git` binary or any other external tool needed.
 
 The two restricted sub-agents that do the background learning (`memorize`,
 `memorize-extract`) register themselves automatically while background learning
@@ -95,7 +95,7 @@ echo 'I prefer TypeScript strict mode and 2-space indentation.' \
 
 ```
 ~/.local/share/opencode/
-├── memory.db                       # the plugin's own database (opencode's is only ever read)
+├── memory.db                       # the plugin's own database (opencode's data is only accessed via its API)
 └── memories/
     ├── memory_summary.md           # compact summary injected into the system prompt
     ├── MEMORY.md                   # searchable index of everything learned
@@ -117,8 +117,10 @@ those too.)
   session transcripts and extracted memories before anything is written or sent
   to a model. Notes you explicitly dictate ("remember that ...") are stored as
   you said them.
-- **The learning agents are sandboxed** — every tool except reading and editing
-  the memory files is denied, including shell and network access.
+- **The learning agents are sandboxed** — the extraction agent has no tools at
+  all (the transcript is handed to it inline), and the consolidation agent gets
+  only file tools plus access to the memory folder. Shell, network, IDE, and
+  MCP tools are denied for both.
 - **Reset is safe.** `memory_reset` refuses to run if the memory folder is a
   symlink, so it can't be tricked into deleting something else.
 - **Web/MCP sessions:** by default, sessions that used web search, fetch, or MCP
@@ -196,6 +198,17 @@ explicitly, so they win over an agent-level `model`.
 ## Under the hood
 
 opencode-codex-memory is a faithful port of the memory system from OpenAI's codex.
+
+One design choice is worth calling out, because it shapes everything else: **memory
+is global.** There's a single store for all your work, not one per project. That's
+not an accident of the port — it's codex's own hard-won shape. codex *started* with
+per-project memory (a separate bucket per directory, plus a user scope) and
+**deliberately removed it** in early 2026, collapsing everything into one global
+root for simplicity: one store, one lock, one consolidation pass. Project awareness
+didn't disappear — it moved out of storage and into the prompt, as soft "this looks
+like it belongs to that project" hints rather than hard partitions. This port
+mirrors that exactly.
+
 If you want to understand the design, the trade-offs, or contribute, see
 [`ARCHITECTURE.md`](./ARCHITECTURE.md). Contributor guidance lives in
 [`CONTRIBUTING.md`](./CONTRIBUTING.md) and [`AGENTS.md`](./AGENTS.md) —

package/dist/src/capture.js

@@ -49,8 +49,10 @@ export async function listRecentSessions(limit = SCAN_LIMIT) {
             continue;
         try {
             const res = await withTimeout(client.session.list({
-                // scope/roots/limit are in the server's ListQuery since 1.17; the
-                // pinned SDK types lag behind, hence the cast at the call site.
+                // scope/roots/limit are in the server's ListQuery (accepted since
+                // opencode 1.14.30, well under our 1.18 floor); the pinned SDK types
+                // still omit them (SessionListData.query is just { directory } as of
+                // 1.18.1), hence the cast at the call site.
                 query: { directory: project.worktree, scope: "project", roots: true, limit },
             }), API_TIMEOUT_MS, "session.list");
             if (!res || res.error || !Array.isArray(res.data))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-codex-memory",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Persistent memory plugin for opencode — ports codex's two-phase memory system (extraction → consolidation → injection → citation feedback)",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -45,7 +45,7 @@
   ],
   "license": "Apache-2.0",
   "dependencies": {
-    "@opencode-ai/plugin": "^1.17.13",
+    "@opencode-ai/plugin": "^1.18.0",
     "diff": "^9.0.0",
     "isomorphic-git": "^1.38.6"
   },