mira-cli-ts 0.26.5 → 0.26.7

package/dist/cli.js

@@ -136,6 +136,11 @@ Usage:
   mira config get [key]                                   Get config (or filtered by key)
   mira config set <key> <value>                            Set config (dot notation, JSON value)
   mira finding list [--status open] [--limit 20]          List findings
+  mira workspace list                                     List workspaces (recent)
+  mira workspace add <path>                               Add workspace (validates path)
+  mira workspace remove <id|path>                         Remove workspace
+  mira workspace switch <id|path>                         Switch workspace (sets cwd for new sessions)
+  mira project init [--template ts] [--path <dir>]        Init mira.json in project
   mira manager                                            Active jobs + recent sessions
   mira health                                             Liveness (/healthz)
   mira complete --prefix "..." [--suffix "..."] [--file path]  Ghost-text completion
@@ -145,11 +150,15 @@ Usage:
 Env:
   MIRA_API_URL  server URL (default http://127.0.0.1:4096)
   MIRA_TOKEN    bearer token
+  MIRA_WORKSPACE  single workspace path (env)
+  MIRA_WORKSPACE_ROOTS  comma-separated workspace roots (env)
 
 Examples:
   mira serve
   mira session create --agent ask --title "Q&A"
   mira session prompt --id abc --prompt "explain ./src/index.ts"
+  mira workspace add /path/to/repo
+  mira project init --template ts
   mira skill list
   mira command list
   mira tool list
@@ -501,6 +510,282 @@ async function cmdHealth() {
   }
   console.log(JSON.stringify(await res.json(), null, 2));
 }
+async function cmdWorkspaceList() {
+  try {
+    const res = await apiFetch("/workspaces");
+    if (!res.ok) {
+      console.error(`workspace list failed: ${res.status} ${await res.text()}`);
+      process.exit(1);
+    }
+    const data = await res.json();
+    const list = data.workspaces ?? [];
+    if (list.length === 0) {
+      console.log("No workspaces \u2014 add one with: mira workspace add /path/to/repo");
+      return;
+    }
+    for (const w of list) {
+      console.log(`${w.id.slice(0, 8)}  ${w.path}  (${w.name})`);
+    }
+  } catch (e) {
+    try {
+      const { readFileSync, existsSync } = __require("fs");
+      const home = process.env.HOME ?? "";
+      const fp = home ? `${home}/.mira/workspaces.json` : `${process.cwd()}/.mira/workspaces.json`;
+      if (existsSync(fp)) {
+        const raw = readFileSync(fp, "utf-8");
+        const parsed = JSON.parse(raw);
+        const list = Array.isArray(parsed) ? parsed : parsed.workspaces ?? [];
+        if (list.length === 0)
+          console.log("No workspaces");
+        else
+          for (const w of list)
+            console.log(`${(w.id ?? "").slice(0, 8)}  ${w.path}  (${w.name ?? w.path.split("/").pop()})`);
+        return;
+      }
+    } catch {}
+    console.error(`workspace list failed: ${String(e.message ?? e)}`);
+    process.exit(1);
+  }
+}
+async function cmdWorkspaceAdd(opts) {
+  const positional = Bun.argv.slice(3).filter((a) => !a.startsWith("-"));
+  let rawPath = String(opts.path ?? opts.p ?? opts["1"] ?? positional[1] ?? "").trim();
+  if (!rawPath || rawPath === "add")
+    rawPath = String(positional[1] ?? opts["1"] ?? "").trim();
+  if (!rawPath)
+    rawPath = String(positional[0] ?? "").trim();
+  if (!rawPath || rawPath === "add") {
+    console.error("workspace add requires <path> \u2014 e.g. mira workspace add /path/to/repo");
+    process.exit(1);
+  }
+  try {
+    const res = await apiFetch("/workspaces", { method: "POST", body: JSON.stringify({ path: rawPath }) });
+    if (!res.ok) {
+      console.error(`workspace add failed: ${res.status} ${await res.text()}`);
+      process.exit(1);
+    }
+    const data = await res.json();
+    console.log(`Added workspace: ${data.workspace.path} (${data.workspace.id.slice(0, 8)})`);
+    console.log(JSON.stringify(data.workspace, null, 2));
+  } catch (e) {
+    const msg = String(e.message ?? e);
+    const isConn = msg.includes("ECONNREFUSED") || msg.includes("fetch failed") || msg.includes("Connection refused") || msg.includes("Unable to connect") || msg.includes("ECONNRESET");
+    if (!isConn) {
+      console.error(`workspace add failed: ${msg}`);
+      process.exit(1);
+    }
+    try {
+      const { readFileSync, existsSync, mkdirSync, writeFileSync } = __require("fs");
+      const { resolve } = __require("path");
+      const absPath = rawPath.startsWith("/") ? rawPath : resolve(process.cwd(), rawPath);
+      if (!existsSync(absPath)) {
+        console.error(`path not found: ${absPath}`);
+        process.exit(1);
+      }
+      const home = process.env.HOME ?? "";
+      const fp = home ? `${home}/.mira/workspaces.json` : `${process.cwd()}/.mira/workspaces.json`;
+      const dir = fp.slice(0, fp.lastIndexOf("/"));
+      if (dir)
+        mkdirSync(dir, { recursive: true });
+      let existing = [];
+      if (existsSync(fp)) {
+        try {
+          const raw = readFileSync(fp, "utf-8");
+          const parsed = JSON.parse(raw);
+          existing = Array.isArray(parsed) ? parsed : parsed.workspaces ?? [];
+        } catch {}
+      }
+      if (existing.some((w) => w.path === absPath)) {
+        console.log(`Workspace already exists: ${absPath}`);
+        return;
+      }
+      const id = Buffer.from(absPath).toString("base64url");
+      const entry = { id, path: absPath, name: absPath.split("/").pop() || absPath, addedAt: Date.now() };
+      existing.push(entry);
+      writeFileSync(fp, JSON.stringify({ workspaces: existing }, null, 2) + `
+`);
+      console.log(`Added workspace (offline): ${absPath} (${id.slice(0, 8)})`);
+    } catch (err) {
+      console.error(`workspace add failed: ${String(err.message ?? err)}`);
+      process.exit(1);
+    }
+  }
+}
+async function cmdWorkspaceRemove(opts) {
+  const positional = Bun.argv.slice(3).filter((a) => !a.startsWith("-"));
+  let id = String(opts.id ?? opts["1"] ?? positional[1] ?? "").trim();
+  if (!id || id === "remove" || id === "rm" || id === "delete")
+    id = String(positional[1] ?? opts["1"] ?? "").trim();
+  if (!id)
+    id = String(positional[0] ?? "").trim();
+  if (!id || ["remove", "rm", "delete"].includes(id)) {
+    console.error("workspace remove requires <id|path> \u2014 e.g. mira workspace remove <id>");
+    process.exit(1);
+  }
+  try {
+    const res = await apiFetch(`/workspaces/${encodeURIComponent(id)}`, { method: "DELETE" });
+    if (!res.ok) {
+      console.error(`workspace remove failed: ${res.status} ${await res.text()}`);
+      process.exit(1);
+    }
+    console.log(JSON.stringify(await res.json(), null, 2));
+    return;
+  } catch (e) {
+    const msg = String(e.message ?? e);
+    const isConn = msg.includes("ECONNREFUSED") || msg.includes("fetch failed") || msg.includes("Connection refused") || msg.includes("Unable to connect") || msg.includes("ECONNRESET");
+    if (!isConn) {
+      console.error(`workspace remove failed: ${msg}`);
+      process.exit(1);
+    }
+    try {
+      const { readFileSync, existsSync, writeFileSync } = __require("fs");
+      const home = process.env.HOME ?? "";
+      const fp = home ? `${home}/.mira/workspaces.json` : `${process.cwd()}/.mira/workspaces.json`;
+      if (!existsSync(fp)) {
+        console.error(`workspace not found: ${id}`);
+        process.exit(1);
+      }
+      const raw = readFileSync(fp, "utf-8");
+      const parsed = JSON.parse(raw);
+      const list = Array.isArray(parsed) ? parsed : parsed.workspaces ?? [];
+      const idx = list.findIndex((w) => w.id === id || w.path === id || w.id.startsWith(id) || w.path.endsWith(id));
+      if (idx === -1) {
+        console.error(`workspace not found: ${id}`);
+        process.exit(1);
+      }
+      const removed = list[idx];
+      const next = list.filter((_, i) => i !== idx);
+      writeFileSync(fp, JSON.stringify({ workspaces: next }, null, 2) + `
+`);
+      console.log(`Removed workspace (offline): ${removed.path}`);
+      console.log(JSON.stringify({ ok: true, removed }, null, 2));
+    } catch (err) {
+      console.error(`workspace remove failed: ${String(err.message ?? err)}`);
+      process.exit(1);
+    }
+  }
+}
+async function cmdWorkspaceSwitch(opts) {
+  const positional = Bun.argv.slice(3).filter((a) => !a.startsWith("-"));
+  let target = String(opts.path ?? opts["1"] ?? positional[1] ?? "").trim();
+  if (!target || target === "switch")
+    target = String(positional[1] ?? opts["1"] ?? "").trim();
+  if (!target)
+    target = String(positional[0] ?? "").trim();
+  try {
+    const res = await apiFetch("/workspaces");
+    if (res.ok) {
+      const data = await res.json();
+      const found = data.workspaces.find((w) => w.id === target || w.path === target || w.id.startsWith(target) || w.path.endsWith(target));
+      if (found) {
+        console.log(`Switched to workspace: ${found.path} (${found.name})`);
+        console.log(`Set MIRA_WORKSPACE=${found.path} for new sessions (export MIRA_WORKSPACE="${found.path}")`);
+        return;
+      }
+      console.error(`workspace not found: ${target}`);
+      process.exit(1);
+    }
+  } catch {}
+  try {
+    const { readFileSync, existsSync } = __require("fs");
+    const home = process.env.HOME ?? "";
+    const fp = home ? `${home}/.mira/workspaces.json` : `${process.cwd()}/.mira/workspaces.json`;
+    if (existsSync(fp)) {
+      const raw = readFileSync(fp, "utf-8");
+      const parsed = JSON.parse(raw);
+      const list = Array.isArray(parsed) ? parsed : parsed.workspaces ?? [];
+      const found = list.find((w) => w.id === target || w.path === target || w.id.startsWith(target));
+      if (found) {
+        console.log(`Switched to workspace: ${found.path} (${found.name ?? found.path.split("/").pop()})`);
+        console.log(`Set MIRA_WORKSPACE=${found.path} for new sessions (export MIRA_WORKSPACE="${found.path}")`);
+        return;
+      }
+    }
+  } catch {}
+  console.error(`workspace not found: ${target}`);
+  process.exit(1);
+}
+async function cmdProjectInit(opts) {
+  const template = String(opts.template ?? opts.t ?? "default").trim() || "default";
+  const targetPath = String(opts.path ?? opts.p ?? positionalPath() ?? process.cwd()).trim() || process.cwd();
+  function positionalPath() {
+    const positional = Bun.argv.slice(3).filter((a) => !a.startsWith("-"));
+    const tIdx = Bun.argv.indexOf("--template");
+    const tIdx2 = Bun.argv.indexOf("-t");
+    let afterTemplate = -1;
+    if (tIdx !== -1)
+      afterTemplate = tIdx + 2;
+    else if (tIdx2 !== -1)
+      afterTemplate = tIdx2 + 2;
+    if (afterTemplate !== -1 && Bun.argv[afterTemplate] && !Bun.argv[afterTemplate].startsWith("-"))
+      return Bun.argv[afterTemplate];
+    if (template !== "default" && positional.length > 0) {
+      if (positional[0] === template)
+        return positional[1];
+    }
+    return positional[0];
+  }
+  const { existsSync, mkdirSync, writeFileSync, readFileSync } = __require("fs");
+  const { resolve } = __require("path");
+  const absPath = targetPath.startsWith("/") ? targetPath : resolve(process.cwd(), targetPath);
+  try {
+    mkdirSync(absPath, { recursive: true });
+  } catch {}
+  const miraJsonPath = `${absPath}/mira.json`;
+  if (existsSync(miraJsonPath)) {
+    console.error(`mira.json already exists at ${miraJsonPath} \u2014 refusing to overwrite`);
+    process.exit(1);
+  }
+  let config;
+  if (template === "ts" || template === "typescript") {
+    config = {
+      model: "openrouter/anthropic/claude-sonnet-4",
+      permission: { bash: "ask", read: "allow", write: "ask", edit: "ask" },
+      guardrails: { allowedRoots: ["."], enforce: false },
+      mcp: {},
+      provider: {},
+      agents: {}
+    };
+  } else {
+    config = {
+      model: "openrouter/anthropic/claude-sonnet-4",
+      permission: {},
+      mcp: {},
+      provider: {}
+    };
+  }
+  writeFileSync(miraJsonPath, JSON.stringify(config, null, 2) + `
+`);
+  console.log(`Created ${miraJsonPath} (template: ${template})`);
+  try {
+    const res = await apiFetch("/workspaces", { method: "POST", body: JSON.stringify({ path: absPath }) });
+    if (res.ok) {
+      const data = await res.json();
+      console.log(`Registered workspace: ${data.workspace.path}`);
+    }
+  } catch {}
+  try {
+    const home = process.env.HOME ?? "";
+    const fp = home ? `${home}/.mira/workspaces.json` : `${process.cwd()}/.mira/workspaces.json`;
+    const dir = fp.slice(0, fp.lastIndexOf("/"));
+    if (dir)
+      mkdirSync(dir, { recursive: true });
+    let existing = [];
+    if (existsSync(fp)) {
+      try {
+        const raw = readFileSync(fp, "utf-8");
+        const parsed = JSON.parse(raw);
+        existing = Array.isArray(parsed) ? parsed : parsed.workspaces ?? [];
+      } catch {}
+    }
+    if (!existing.some((w) => w.path === absPath)) {
+      const id = Buffer.from(absPath).toString("base64url");
+      existing.push({ id, path: absPath, name: absPath.split("/").pop() || absPath, addedAt: Date.now() });
+      writeFileSync(fp, JSON.stringify({ workspaces: existing }, null, 2) + `
+`);
+    }
+  } catch {}
+}
 async function main() {
   const rawCmd = Bun.argv[2] ?? "help";
   if (rawCmd.startsWith("/")) {
@@ -610,6 +895,35 @@ async function main() {
         process.exit(1);
       }
       return;
+    case "workspace":
+    case "workspaces":
+      if (sub === "list" || sub === null)
+        await cmdWorkspaceList();
+      else if (sub === "add")
+        await cmdWorkspaceAdd(opts);
+      else if (sub === "remove" || sub === "rm" || sub === "delete")
+        await cmdWorkspaceRemove(opts);
+      else if (sub === "switch")
+        await cmdWorkspaceSwitch(opts);
+      else {
+        if (sub && !["list", "add", "remove", "rm", "delete", "switch"].includes(sub)) {
+          opts["path"] = sub;
+          await cmdWorkspaceAdd(opts);
+          return;
+        }
+        console.error(`unknown workspace subcommand: ${sub ?? ""} \u2014 try: list, add, remove, switch`);
+        process.exit(1);
+      }
+      return;
+    case "project":
+    case "projects":
+      if (sub === "init" || sub === null)
+        await cmdProjectInit(opts);
+      else {
+        console.error(`unknown project subcommand: ${sub ?? ""} \u2014 try: init`);
+        process.exit(1);
+      }
+      return;
     case "complete":
     case "autocomplete":
       await cmdComplete(opts);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mira-cli-ts",
-  "version": "0.26.5",
+  "version": "0.26.7",
   "description": "Mira CLI — thin wrapper around @mira/server (serve + session/agent/complete)",
   "type": "module",
   "bin": {