@memfork/cli 0.1.47 → 0.1.48

package/dist/cli.js

@@ -66,6 +66,16 @@ program
     .command("status")
     .description("show current tree, network, branch, and signer")
     .action(wrap(cmdStatus));
+program
+    .command("namespace [branch]")
+    .description("print the MemWal namespace for a branch (use with memwal_recall namespace= arg)")
+    .action(wrap(async (branch) => {
+    const { cfg } = await import("./config.js").then((m) => ({ cfg: m.resolveConfig() }));
+    const { resolveBranch } = await import("./branch.js");
+    const { branchNamespace } = await import("@memfork/core");
+    const b = resolveBranch({ explicit: branch, configDefault: cfg.defaultBranch });
+    console.log(branchNamespace(cfg.treeId, b));
+}));
 program
     .command("log")
     .description("show recent commits on a branch")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memfork/cli",
-  "version": "0.1.47",
+  "version": "0.1.48",
   "description": "MemForks CLI — init, commit, recall, merge, install plugins",
   "repository": {
     "type": "git",

package/plugins/codex/plugins/memforks/README.md

@@ -54,7 +54,8 @@ memfork doctor
 | `memfork merge <src> <dst>` | Propose a cross-branch memory merge |
 | `memfork status / log / proposals` | Inspect the on-chain DAG |
 
-Memory is namespaced by Git branch — `namespace="branch/<branch-name>"`.
+Memory is namespaced by Git branch in the form `memforks/<treeId>/<branch>`.
+Run `memfork namespace` to get the exact string for the current branch.
 
 ## What gets installed
 

package/plugins/codex/plugins/memforks/skills/memory-recall/SKILL.md

@@ -12,24 +12,38 @@ Do not run `memfork recall` from the shell; the MCP tool is faster and context-a
 
 ## Usage
 
+MemWal namespaces are scoped to the tree in the form `memforks/<treeId>/<branch>`.
+Get the correct namespace first:
+
+```bash
+memfork namespace                  # current branch
+memfork namespace feat/auth        # specific branch
+```
+
+Then recall:
+
 ```
 memwal_recall(
   query="<natural language — what you want to find>",
-  namespace="branch/<current-git-branch>",
+  namespace="memforks/<treeId>/<current-git-branch>",
   limit=5
 )
 ```
 
+If you cannot run `memfork namespace`, omit `namespace` entirely — MemWal will search
+the full account across all branches.
+
 Examples:
 ```
-memwal_recall(query="auth system design", namespace="branch/main")
-memwal_recall(query="database schema decisions", namespace="branch/feature/payments")
+memwal_recall(query="auth system design", namespace="memforks/<treeId>/main")
+memwal_recall(query="database schema decisions", namespace="memforks/<treeId>/feature/payments")
 memwal_recall(query="what do we know about the API rate limits?", limit=10)
 ```
 
 ## Rules
 
 - Always scope to the current Git branch namespace unless the user asks for cross-branch context.
+  Use `memfork namespace` to get the exact string; never guess `branch/<name>`.
 - High relevance scores = verified prior context.
 - If recall returns nothing, tell the user memory is empty for this branch and offer to start capturing.
 - Never fabricate facts — only use what `memwal_recall` returns.

package/plugins/cursor/rules/memforks.mdc

@@ -21,11 +21,20 @@ have been discussed before, call the MCP tool:
 memwal_recall(query="<natural language query>", limit=5)
 ```
 
-Use the namespace matching the current Git branch:
+Use the namespace matching the current Git branch. Get the exact value from the CLI first:
 
+```bash
+memfork namespace              # prints: memforks/<treeId>/<current-branch>
+memfork namespace feat/auth    # prints namespace for a specific branch
 ```
-memwal_recall(query="auth system design decisions", namespace="branch/<current-branch>")
+
+Then pass it to the MCP tool:
+
 ```
+memwal_recall(query="auth system design decisions", namespace="memforks/<treeId>/feat/auth")
+```
+
+If you cannot run the CLI, omit `namespace` — MemWal will search the full account across all branches.
 
 Results with high relevance scores are verified context from prior sessions.
 
@@ -111,7 +120,9 @@ human governance act.
 ## Branch awareness
 
 - The `memfork` CLI auto-detects the current Git branch; pass `--branch` only to override it.
-- The `memwal_*` MCP tools have no Git context, so pass `namespace="branch/<current-branch>"` explicitly.
+- The `memwal_*` MCP tools have no Git context. MemWal namespaces are in the form
+  `memforks/<treeId>/<branch>` — get the exact value with `memfork namespace <branch>`,
+  then pass it as `namespace=` to recall. Without it, omit namespace to search all branches.
 - When the user switches branches, recall from the new branch namespace.
 - Use `memfork status` to see the current branch, on-chain tree state, and open merge proposals.