clawmem 0.3.2 → 0.3.4

package/AGENTS.md

@@ -663,8 +663,9 @@ echo "user query" | clawmem surface --context --stdin
 echo "session-id" | clawmem surface --bootstrap --stdin
 ```
 
-**Analysis commands:**
+**Browse and analysis:**
 ```bash
+clawmem list [-n N] [-c col]    # Browse recent documents (--json for machine output)
 clawmem reflect [N]             # Cross-session reflection (last N days, default 14)
                                 # Shows recurring themes, antipatterns, co-activation clusters
 clawmem consolidate [--dry-run] # Find and archive duplicate low-confidence documents

package/CLAUDE.md

@@ -663,8 +663,9 @@ echo "user query" | clawmem surface --context --stdin
 echo "session-id" | clawmem surface --bootstrap --stdin
 ```
 
-**Analysis commands:**
+**Browse and analysis:**
 ```bash
+clawmem list [-n N] [-c col]    # Browse recent documents (--json for machine output)
 clawmem reflect [N]             # Cross-session reflection (last N days, default 14)
                                 # Shows recurring themes, antipatterns, co-activation clusters
 clawmem consolidate [--dry-run] # Find and archive duplicate low-confidence documents

package/README.md

@@ -615,6 +615,7 @@ clawmem profile                                 Show user profile
 clawmem profile rebuild                         Force profile rebuild
 clawmem update-context                          Regenerate per-folder CLAUDE.md
 
+clawmem list [-n/--limit N] [-c col] [--json]   Browse recent documents
 clawmem budget [--session ID]                   Token utilization
 clawmem log [--last N]                          Session history
 clawmem hook <name>                             Manual hook trigger

package/SKILL.md

@@ -684,9 +684,10 @@ clawmem reindex --enrich        # Full A-MEM pipeline on ALL docs (entity extrac
                                 # Without --enrich, reindex only refreshes metadata for changed docs.
 ```
 
-### Analysis Commands
+### Browse and Analysis
 
 ```bash
+clawmem list [-n N] [-c col]    # Browse recent documents (--json for machine output)
 clawmem reflect [N]             # Cross-session reflection (last N days, default 14)
                                 # Recurring themes, antipatterns, co-activation clusters
 clawmem consolidate [--dry-run] # Find and archive duplicate low-confidence documents

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawmem",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "On-device context engine and memory for AI agents. Claude Code and OpenClaw. Hooks + MCP server + hybrid RAG search.",
   "type": "module",
   "bin": {

package/src/clawmem.ts

@@ -461,6 +461,81 @@ async function cmdStatus() {
   }
 }
 
+async function cmdList(args: string[]) {
+  const { values } = parseArgs({
+    args,
+    options: {
+      num: { type: "string", short: "n", default: "10" },
+      limit: { type: "string" }, // alias for --num (matches issue request)
+      collection: { type: "string", short: "c" },
+      json: { type: "boolean", default: false },
+    },
+    allowPositionals: false,
+  });
+
+  const limit = parseInt(values.limit || values.num!, 10);
+  if (isNaN(limit) || limit < 1) die("--num must be a positive integer");
+
+  const s = getStore();
+  const col = values.collection || null;
+
+  const rows = s.db.prepare(`
+    SELECT
+      substr(hash, 1, 6) AS docid,
+      title,
+      collection,
+      path,
+      content_type,
+      modified_at,
+      confidence,
+      access_count
+    FROM documents
+    WHERE active = 1
+      AND invalidated_at IS NULL
+      AND (? IS NULL OR collection = ?)
+    ORDER BY COALESCE(modified_at, created_at) DESC, id DESC
+    LIMIT ?
+  `).all(col, col, limit) as {
+    docid: string;
+    title: string | null;
+    collection: string;
+    path: string;
+    content_type: string | null;
+    modified_at: string | null;
+    confidence: number | null;
+    access_count: number | null;
+  }[];
+
+  if (rows.length === 0) {
+    console.log(col ? `No documents in collection "${col}".` : "No documents in vault.");
+    return;
+  }
+
+  if (values.json) {
+    console.log(JSON.stringify(rows.map(r => ({
+      docid: r.docid,
+      title: r.title || null,
+      collection: r.collection,
+      path: r.path,
+      contentType: r.content_type || "note",
+      modifiedAt: r.modified_at || null,
+      confidence: r.confidence ?? 1.0,
+      accessCount: r.access_count ?? 0,
+    })), null, 2));
+    return;
+  }
+
+  console.log(`${c.bold}Recent documents${col ? ` (${col})` : ""}:${c.reset}\n`);
+  for (const r of rows) {
+    const date = r.modified_at?.slice(0, 10) || "-";
+    const type = r.content_type || "note";
+    const raw = r.title || r.path;
+    const title = raw.length > 60 ? raw.slice(0, 57) + "..." : raw;
+    console.log(`  ${c.dim}${r.docid}${c.reset}  ${date}  ${c.dim}[${type}]${c.reset}  ${r.collection}  ${title}`);
+  }
+  console.log(`\n${rows.length} document${rows.length !== 1 ? "s" : ""} shown.`);
+}
+
 async function cmdSearch(args: string[]) {
   const { values, positionals } = parseArgs({
     args,
@@ -1626,6 +1701,9 @@ async function main() {
       case "status":
         await cmdStatus();
         break;
+      case "list":
+        await cmdList(subArgs);
+        break;
       case "search":
         await cmdSearch(subArgs);
         break;
@@ -2222,6 +2300,7 @@ ${c.bold}Search:${c.reset}
   clawmem query <query> [-n N]         Hybrid + rerank (best)
 
 ${c.bold}Memory:${c.reset}
+  clawmem list [-n/--limit N] [-c col]  Browse recent documents (--json for machine output)
   clawmem budget [--session ID]        Token utilization
   clawmem log [--last N]               Session history
   clawmem profile                      Show user profile