memshell 0.2.0 → 0.2.1

package/bin/memshell.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+'use strict';
+
+const mem = require('../src/index');
+
+const args = process.argv.slice(2);
+const cmd = args[0];
+const rest = args.slice(1).join(' ');
+
+const HELP = `
+  mem.sh — persistent memory for AI agents
+
+  Usage:
+    mem set <text>          Store a memory
+    mem recall <query>      Semantic recall
+    mem list                List all memories
+    mem forget <id>         Delete a memory by ID
+    mem clear               Wipe all memories
+    mem serve [--port N]    Start API server
+
+  Options:
+    --agent <name>          Agent namespace
+    --api <url>             Use remote API instead of local
+    --key <key>             API key for remote server
+
+  Examples:
+    mem set "user prefers dark mode"
+    mem recall "what theme?"
+    mem list
+    mem forget 3
+`;
+
+// Parse flags
+function flag(name) {
+  const i = args.indexOf('--' + name);
+  if (i === -1) return null;
+  return args[i + 1] || true;
+}
+
+async function main() {
+  const agent = flag('agent') || 'default';
+  const api = flag('api');
+  const key = flag('key');
+
+  if (api) mem.configure({ api, key, agent });
+  else mem.configure({ agent });
+
+  const opts = { agent };
+
+  switch (cmd) {
+    case 'set': case 's': case 'save': case 'remember': {
+      const text = args.slice(1).filter(a => !a.startsWith('--')).join(' ').replace(/^["']|["']$/g, '');
+      if (!text) return console.log('Usage: mem set <text>');
+      const r = await mem.set(text, opts);
+      console.log(`✓ Stored (id: ${r.id})`);
+      break;
+    }
+    case 'recall': case 'r': case 'search': case 'q': {
+      const query = args.slice(1).filter(a => !a.startsWith('--')).join(' ').replace(/^["']|["']$/g, '');
+      if (!query) return console.log('Usage: mem recall <query>');
+      const results = await mem.recall(query, opts);
+      if (!results.length) return console.log('No memories found.');
+      for (const r of results) {
+        console.log(`  [${r.id}] ${r.text} (score: ${r.score})`);
+      }
+      break;
+    }
+    case 'list': case 'ls': case 'l': {
+      const all = await mem.list(opts);
+      if (!all.length) return console.log('No memories stored.');
+      for (const r of all) {
+        console.log(`  [${r.id}] ${r.text}  (${r.created_at})`);
+      }
+      console.log(`\n  ${all.length} memor${all.length === 1 ? 'y' : 'ies'}`);
+      break;
+    }
+    case 'forget': case 'delete': case 'rm': {
+      const id = args[1];
+      if (!id) return console.log('Usage: mem forget <id>');
+      await mem.forget(id);
+      console.log(`✓ Forgotten (id: ${id})`);
+      break;
+    }
+    case 'clear': case 'wipe': case 'reset': {
+      await mem.clear(opts);
+      console.log('✓ All memories cleared');
+      break;
+    }
+    case 'serve': case 'server': {
+      const port = flag('port') || 3456;
+      const authKey = flag('key') || process.env.MEM_KEY || '';
+      process.env.MEM_PORT = port;
+      if (authKey) process.env.MEM_KEY = authKey;
+      require('../server');
+      break;
+    }
+    default:
+      console.log(HELP);
+  }
+}
+
+main().catch(e => { console.error('Error:', e.message); process.exit(1); });

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "memshell",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Persistent memory for AI agents. Like localStorage but for LLMs.",
   "main": "src/index.js",
   "bin": {
-    "memshell": "./bin/mem.js"
+    "memshell": "bin/memshell.js"
   },
   "scripts": {
     "start": "node server.js",