@illli-studio/mory 0.1.1 → 0.1.3

package/README.md

@@ -6,6 +6,7 @@ Local-first memory runtime with a web console and a generic MCP server.
 npm install -g @illli-studio/mory
 mory init
 mory start
+mory start --background
 mory status
 mory stop
 mory export ./mory-export.json
@@ -13,6 +14,7 @@ mory import ./mory-export.json
 ```
 
 For MCP clients, use `mory mcp` as a stdio server. Set `MORY_API_URL` and `MORY_API_TOKEN` when the API is managed separately.
+Use `mory mcp --check` to diagnose the local API connection without starting the stdio protocol.
 
 The same package also exports the TypeScript client:
 

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@illli-studio/mory",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Local-first memory runtime with a web console and MCP server.",
   "license": "AGPL-3.0-or-later",
   "publishConfig": { "access": "public" },
   "type": "module",
   "bin": {
-    "mory": "./bin/mory.mjs"
+    "mory": "./bin/mory"
   },
   "exports": {
     ".": { "types": "./client/index.d.ts", "import": "./client/index.js" },

package/src/cli.mjs

@@ -32,22 +32,34 @@ async function waitForHealth(base, token, timeout = 8000) {
   return false;
 }
 
-async function start() {
+async function start(background = false) {
   const current = config();
   const base = `http://127.0.0.1:${current.port}`;
   if (await waitForHealth(base, current.token, 500)) { console.log(`Mory is already running at ${base}`); return; }
   const env = { ...process.env, MORY_PORT: String(current.port), MORY_API_TOKEN: current.token, MORY_DATABASE: current.database, MORY_WEB_DIST: webDist() };
-  const child = spawn(process.execPath, [apiEntry()], { env, stdio: "inherit", detached: false });
+  const child = spawn(process.execPath, [apiEntry()], { env, stdio: background ? "ignore" : "inherit", detached: background });
   if (!await waitForHealth(base, current.token)) { child.kill(); throw new Error("Mory failed to start. Run `mory doctor` for diagnostics."); }
   writeFileSync(pidPath, String(child.pid));
   child.once("exit", () => { if (existsSync(pidPath) && readFileSync(pidPath, "utf8").trim() === String(child.pid)) unlinkSync(pidPath); });
+  if (background) child.unref();
   console.log(`Mory is running at ${base}`);
   console.log(`Data: ${current.database}`);
   console.log("MCP: run `mory mcp` from your agent configuration");
+  if (background) console.log("Running in background. Use `mory status` or `mory stop`.");
+  if (background) return;
   process.on("SIGINT", () => child.kill("SIGINT"));
   process.on("SIGTERM", () => child.kill("SIGTERM"));
 }
 
+async function mcpCheck() {
+  const current = config();
+  const base = process.env.MORY_API_URL || `http://127.0.0.1:${current.port}`;
+  const token = process.env.MORY_API_TOKEN || current.token;
+  const response = await fetch(base.replace(/\/$/, "") + "/health", { headers: { authorization: `Bearer ${token}` } });
+  console.log(JSON.stringify({ api: base, reachable: response.ok, mcp: "ready", protocol: "2025-06-18" }, null, 2));
+  if (!response.ok) process.exitCode = 1;
+}
+
 async function stop() {
   const current = config();
   if (!await waitForHealth(`http://127.0.0.1:${current.port}`, current.token, 500)) { if (existsSync(pidPath)) unlinkSync(pidPath); console.log("Mory is not running."); return; }
@@ -92,10 +104,11 @@ async function importMemories(inputPath) {
 const [command = "start", ...args] = process.argv.slice(2);
 try {
   if (command === "init") { config(); console.log(`Initialized Mory at ${dataDir}`); }
-  else if (command === "start") await start();
+  else if (command === "start") await start(args.includes("--background") || args.includes("-d"));
   else if (command === "stop") await stop();
   else if (command === "export") await exportMemories(args[0]);
   else if (command === "import") await importMemories(args[0]);
+  else if (command === "mcp" && args.includes("--check")) await mcpCheck();
   else if (command === "mcp") await runMcp({ baseUrl: process.env.MORY_API_URL || `http://127.0.0.1:${config().port}`, token: process.env.MORY_API_TOKEN || config().token });
   else if (command === "doctor") await doctor();
   else if (command === "status") { const c = config(); console.log(JSON.stringify({ url: `http://127.0.0.1:${c.port}`, dataDir, running: await waitForHealth(`http://127.0.0.1:${c.port}`, c.token, 500) }, null, 2)); }