@boxcrew/cli 0.1.15 → 0.1.17

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
+import { createRequire } from "module";
 import { Command } from "commander";
 
 // src/commands/login.ts
@@ -103,6 +104,10 @@ function registerLogoutCommand(program2) {
   });
 }
 
+// src/commands/agents.ts
+import { readdirSync as readdirSync2 } from "fs";
+import { homedir as homedir2 } from "os";
+
 // src/client.ts
 function getBaseUrl() {
   return process.env.BOXCREW_API_URL || config.get("apiUrl");
@@ -141,6 +146,64 @@ async function apiFetchJson(path, options = {}) {
   return response.json();
 }
 
+// src/lib/state.ts
+import { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var RUNTIME_NAMES = {
+  "claude-code": "Claude Code",
+  "opencode": "OpenCode",
+  "openclaw": "OpenClaw"
+};
+function getStateDir() {
+  const dir = join(homedir(), ".boxcrew");
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  return dir;
+}
+function getPidFile(key) {
+  return join(getStateDir(), `${key}.pid`);
+}
+function getMetaFile(key) {
+  return join(getStateDir(), `${key}.meta.json`);
+}
+function getLogFile(key) {
+  return join(getStateDir(), `${key}.log`);
+}
+function readMeta(key) {
+  const metaFile = getMetaFile(key);
+  if (!existsSync(metaFile)) return null;
+  try {
+    return JSON.parse(readFileSync(metaFile, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function readPid(key) {
+  const pidFile = getPidFile(key);
+  if (!existsSync(pidFile)) return null;
+  const pid = parseInt(readFileSync(pidFile, "utf-8").trim(), 10);
+  if (isNaN(pid)) return null;
+  try {
+    process.kill(pid, 0);
+    return pid;
+  } catch {
+    unlinkSync(pidFile);
+    return null;
+  }
+}
+function resolveAgentKey(nameOrId) {
+  if (UUID_RE.test(nameOrId)) return nameOrId;
+  const stateDir = getStateDir();
+  const metaFiles = readdirSync(stateDir).filter((f) => f.endsWith(".meta.json"));
+  for (const file of metaFiles) {
+    const key = file.replace(".meta.json", "");
+    const meta = readMeta(key);
+    if (meta && meta.agentName === nameOrId) return key;
+  }
+  return null;
+}
+
 // src/commands/agents.ts
 var TRANSIENT_CODES = [
   "ETIMEDOUT",
@@ -164,10 +227,55 @@ function registerAgentsCommands(program2) {
       console.log("No agents found.");
       return;
     }
-    console.log("");
+    const home = homedir2();
+    const shortenPath = (p) => p.startsWith(home) ? "~" + p.slice(home.length) : p;
+    const localMeta = /* @__PURE__ */ new Map();
+    try {
+      const stateDir = getStateDir();
+      const metaFiles = readdirSync2(stateDir).filter((f) => f.endsWith(".meta.json"));
+      for (const file of metaFiles) {
+        const key = file.replace(".meta.json", "");
+        const meta = readMeta(key);
+        if (meta) {
+          localMeta.set(meta.agentId, { pid: readPid(key), cwd: meta.cwd });
+        }
+      }
+    } catch {
+    }
+    const rows = [];
     for (const agent of data) {
-      const model = agent.model ? ` (${agent.model})` : "";
-      console.log(`  ${agent.name}  ${agent.runtime}${model}`);
+      const shortId = agent.id.slice(0, 8);
+      const typeDisplay = agent.agent_type === "remote" ? "BYOA" : "hosted";
+      const runtimeDisplay = RUNTIME_NAMES[agent.runtime] || agent.runtime;
+      let status;
+      let directory = "-";
+      if (agent.agent_type !== "remote") {
+        status = "-";
+      } else {
+        const local = localMeta.get(agent.id);
+        if (local?.pid) {
+          status = "online (here)";
+          directory = shortenPath(local.cwd);
+        } else if (agent.is_online) {
+          status = "online";
+        } else {
+          status = "offline";
+          if (local?.cwd) directory = shortenPath(local.cwd);
+        }
+      }
+      rows.push({ name: agent.name, id: shortId, type: typeDisplay, runtime: runtimeDisplay, status, directory });
+    }
+    const headers = { name: "Name", id: "ID", type: "Type", runtime: "Runtime", status: "Status", directory: "Directory" };
+    const cols = Object.keys(headers);
+    const widths = {};
+    for (const col of cols) {
+      widths[col] = Math.max(headers[col].length, ...rows.map((r) => r[col].length));
+    }
+    const pad = (s, w) => s + " ".repeat(w - s.length);
+    console.log("");
+    console.log(`  ${cols.map((c) => pad(headers[c], widths[c])).join("   ")}`);
+    for (const row of rows) {
+      console.log(`  ${cols.map((c) => pad(row[c], widths[c])).join("   ")}`);
     }
     console.log("");
   });
@@ -359,53 +467,12 @@ function registerApiCommand(program2) {
 // src/commands/connect.ts
 import { spawn } from "child_process";
 import { createInterface as createInterface3 } from "readline";
-import { openSync, mkdirSync, existsSync, writeFileSync, readFileSync, unlinkSync, readdirSync } from "fs";
-import { join } from "path";
-import { homedir, platform, release, hostname } from "os";
+import { openSync, existsSync as existsSync2, writeFileSync, unlinkSync as unlinkSync2, readdirSync as readdirSync3, renameSync } from "fs";
+import { join as join2 } from "path";
+import { homedir as homedir3, platform, release, hostname } from "os";
 import WebSocket from "ws";
 var RECONNECT_BASE_MS = 1e3;
 var RECONNECT_MAX_MS = 3e4;
-var RUNTIME_NAMES = {
-  "claude-code": "Claude Code",
-  "opencode": "OpenCode",
-  "openclaw": "OpenClaw"
-};
-function getStateDir() {
-  const dir = join(homedir(), ".boxcrew");
-  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-  return dir;
-}
-function getPidFile(agentName) {
-  return join(getStateDir(), `${agentName}.pid`);
-}
-function getMetaFile(agentName) {
-  return join(getStateDir(), `${agentName}.meta.json`);
-}
-function readMeta(agentName) {
-  const metaFile = getMetaFile(agentName);
-  if (!existsSync(metaFile)) return null;
-  try {
-    return JSON.parse(readFileSync(metaFile, "utf-8"));
-  } catch {
-    return null;
-  }
-}
-function getLogFile(agentName) {
-  return join(getStateDir(), `${agentName}.log`);
-}
-function readPid(agentName) {
-  const pidFile = getPidFile(agentName);
-  if (!existsSync(pidFile)) return null;
-  const pid = parseInt(readFileSync(pidFile, "utf-8").trim(), 10);
-  if (isNaN(pid)) return null;
-  try {
-    process.kill(pid, 0);
-    return pid;
-  } catch {
-    unlinkSync(pidFile);
-    return null;
-  }
-}
 function parseStreamJsonLine(line) {
   let obj;
   try {
@@ -512,16 +579,16 @@ function parseOpenClawOutput(stdout) {
     return [{ kind: "text", text: stdout.trim() || "No response" }];
   }
 }
-function runDaemon(agentName) {
+function runDaemon(agentId) {
   const wsUrl = process.env._BX_WS_URL;
   const claudePath = process.env._BX_CLAUDE_PATH || "claude";
-  const agentDisplayName = process.env._BX_AGENT_NAME || agentName;
+  const agentDisplayName = process.env._BX_AGENT_NAME || agentId;
   const runtime = process.env._BX_RUNTIME || "claude-code";
   if (!wsUrl) {
     console.error("Missing _BX_WS_URL");
     process.exit(1);
   }
-  writeFileSync(getPidFile(agentName), String(process.pid));
+  writeFileSync(getPidFile(agentId), String(process.pid));
   let activeProcess = null;
   let sendToServer = null;
   let reconnectAttempt = 0;
@@ -634,7 +701,7 @@ function runDaemon(agentName) {
   };
   const cleanup = () => {
     try {
-      unlinkSync(getPidFile(agentName));
+      unlinkSync2(getPidFile(agentId));
     } catch {
     }
   };
@@ -678,6 +745,14 @@ function runDaemon(agentName) {
       if (msg.type === "chat") {
         handleChat(msg);
       }
+      if (msg.type === "rename") {
+        const meta = readMeta(agentId);
+        if (meta) {
+          meta.agentName = msg.newName;
+          writeFileSync(getMetaFile(agentId), JSON.stringify(meta, null, 2));
+        }
+        console.log(`[${(/* @__PURE__ */ new Date()).toISOString()}] Agent renamed to "${msg.newName}"`);
+      }
     });
     ws.on("close", (code, reason) => {
       sendToServer = null;
@@ -718,19 +793,27 @@ function runDaemon(agentName) {
   connect();
 }
 function registerConnectCommand(program2) {
-  program2.command("_daemon <agent-name>", { hidden: true }).action((agentName) => {
-    runDaemon(agentName);
+  program2.command("_daemon <agent-id>", { hidden: true }).action((agentId) => {
+    runDaemon(agentId);
   });
   program2.command("connect <agent-name>").description("Connect a local agent to BoxCrew.").option("--claude-path <path>", "Path to claude CLI binary", "claude").action(async (agentName, options) => {
-    const existingPid = readPid(agentName);
+    const config2 = await apiFetchJson(
+      `/agents/${encodeURIComponent(agentName)}/connection-config`
+    );
+    const agentId = config2.agent_id;
+    if (!existsSync2(getMetaFile(agentId)) && existsSync2(getMetaFile(agentName))) {
+      for (const ext of [".meta.json", ".pid", ".log"]) {
+        const oldPath = join2(getStateDir(), `${agentName}${ext}`);
+        const newPath = join2(getStateDir(), `${agentId}${ext}`);
+        if (existsSync2(oldPath)) renameSync(oldPath, newPath);
+      }
+    }
+    const existingPid = readPid(agentId);
     if (existingPid) {
       console.log(`Agent "${agentName}" is already connected (PID ${existingPid}).`);
       return;
     }
-    const config2 = await apiFetchJson(
-      `/agents/${encodeURIComponent(agentName)}/connection-config`
-    );
-    const logFile = getLogFile(agentName);
+    const logFile = getLogFile(agentId);
     const logFd = openSync(logFile, "a");
     const daemonEnv = {
       ...process.env,
@@ -741,7 +824,7 @@ function registerConnectCommand(program2) {
     };
     delete daemonEnv.CLAUDECODE;
     delete daemonEnv.CLAUDE_CODE_ENTRYPOINT;
-    const child = spawn(process.argv[0], [process.argv[1], "_daemon", agentName], {
+    const child = spawn(process.argv[0], [process.argv[1], "_daemon", agentId], {
       detached: true,
       stdio: ["ignore", logFd, logFd],
       env: daemonEnv
@@ -751,14 +834,15 @@ function registerConnectCommand(program2) {
       pid: child.pid,
       cwd: process.cwd(),
       runtime: config2.runtime,
+      agentId,
       agentName: config2.agent_name,
       connectedAt: (/* @__PURE__ */ new Date()).toISOString(),
       claudePath: options.claudePath
     };
-    writeFileSync(getMetaFile(agentName), JSON.stringify(meta, null, 2));
+    writeFileSync(getMetaFile(agentId), JSON.stringify(meta, null, 2));
     const runtimeDisplay = RUNTIME_NAMES[config2.runtime] || config2.runtime;
     const cwd = process.cwd();
-    const home = homedir();
+    const home = homedir3();
     const shortLog = logFile.startsWith(home) ? "~" + logFile.slice(home.length) : logFile;
     console.log("");
     console.log(`  Agent "${config2.agent_name}" is online.`);
@@ -771,7 +855,12 @@ function registerConnectCommand(program2) {
     console.log("");
   });
   program2.command("disconnect <agent-name>").description("Disconnect a local agent.").action((agentName) => {
-    const pid = readPid(agentName);
+    const key = resolveAgentKey(agentName);
+    if (!key) {
+      console.log(`Agent "${agentName}" is not connected.`);
+      return;
+    }
+    const pid = readPid(key);
     if (!pid) {
       console.log(`Agent "${agentName}" is not connected.`);
       return;
@@ -779,7 +868,7 @@ function registerConnectCommand(program2) {
     try {
       process.kill(pid, "SIGTERM");
       try {
-        unlinkSync(getPidFile(agentName));
+        unlinkSync2(getPidFile(key));
       } catch {
       }
       console.log(`Agent "${agentName}" disconnected.`);
@@ -787,57 +876,17 @@ function registerConnectCommand(program2) {
       console.error(`Failed to stop process ${pid}.`);
     }
   });
-  program2.command("status").description("Show status of all locally connected agents.").action(() => {
-    const stateDir = getStateDir();
-    const metaFiles = readdirSync(stateDir).filter((f) => f.endsWith(".meta.json"));
-    if (metaFiles.length === 0) {
-      console.log("No agents found. Use `bx connect <agent-name>` to connect one.");
-      return;
-    }
-    const home = homedir();
-    const shortenPath = (p) => p.startsWith(home) ? "~" + p.slice(home.length) : p;
-    const rows = [];
-    for (const file of metaFiles) {
-      const agentName = file.replace(".meta.json", "");
-      const meta = readMeta(agentName);
-      if (!meta) continue;
-      const pid = readPid(agentName);
-      const isOnline = pid !== null;
-      rows.push({
-        agent: meta.agentName || agentName,
-        status: isOnline ? "online" : "offline",
-        runtime: RUNTIME_NAMES[meta.runtime] || meta.runtime,
-        directory: shortenPath(meta.cwd),
-        pid: isOnline ? String(pid) : "-"
-      });
-    }
-    const headers = { agent: "Agent", status: "Status", runtime: "Runtime", directory: "Directory", pid: "PID" };
-    const cols = Object.keys(headers);
-    const widths = {};
-    for (const col of cols) {
-      widths[col] = Math.max(headers[col].length, ...rows.map((r) => r[col].length));
-    }
-    const pad = (s, w) => s + " ".repeat(w - s.length);
-    const headerLine = cols.map((c) => pad(headers[c], widths[c])).join("   ");
-    console.log("");
-    console.log(`  ${headerLine}`);
-    for (const row of rows) {
-      const line = cols.map((c) => pad(row[c], widths[c])).join("   ");
-      console.log(`  ${line}`);
-    }
-    console.log("");
-  });
   program2.command("reconnect [agent-name]").description("Reconnect a previously connected agent.").option("--all", "Reconnect all agents").option("--claude-path <path>", "Path to claude CLI binary").action(async (agentName, options) => {
     if (options.all) {
       const stateDir = getStateDir();
-      const metaFiles = readdirSync(stateDir).filter((f) => f.endsWith(".meta.json"));
+      const metaFiles = readdirSync3(stateDir).filter((f) => f.endsWith(".meta.json"));
       if (metaFiles.length === 0) {
         console.log("No agents found. Use `bx connect <agent-name>` to connect one.");
         return;
       }
       for (const file of metaFiles) {
-        const name = file.replace(".meta.json", "");
-        await reconnectAgent(name, options.claudePath);
+        const key2 = file.replace(".meta.json", "");
+        await reconnectAgent(key2, options.claudePath);
       }
       return;
     }
@@ -845,30 +894,36 @@ function registerConnectCommand(program2) {
       console.error("Please specify an agent name or use --all.");
       process.exit(1);
     }
-    await reconnectAgent(agentName, options.claudePath);
+    const key = resolveAgentKey(agentName);
+    if (!key) {
+      console.error(`No previous connection found for "${agentName}". Use \`bx connect ${agentName}\` instead.`);
+      process.exit(1);
+    }
+    await reconnectAgent(key, options.claudePath);
   });
-  async function reconnectAgent(agentName, claudePathOverride) {
-    const meta = readMeta(agentName);
+  async function reconnectAgent(key, claudePathOverride) {
+    const meta = readMeta(key);
     if (!meta) {
-      console.error(`No previous connection found for "${agentName}". Use \`bx connect ${agentName}\` instead.`);
+      console.error(`No previous connection found for "${key}". Use \`bx connect <agent-name>\` instead.`);
       return;
     }
-    const existingPid = readPid(agentName);
+    const existingPid = readPid(key);
     if (existingPid) {
       try {
         process.kill(existingPid, "SIGTERM");
       } catch {
       }
       try {
-        unlinkSync(getPidFile(agentName));
+        unlinkSync2(getPidFile(key));
       } catch {
       }
     }
+    const agentId = meta.agentId || key;
     const config2 = await apiFetchJson(
-      `/agents/${encodeURIComponent(agentName)}/connection-config`
+      `/agents/${encodeURIComponent(agentId)}/connection-config`
     );
     const claudePath = claudePathOverride || meta.claudePath || "claude";
-    const logFile = getLogFile(agentName);
+    const logFile = getLogFile(key);
     const logFd = openSync(logFile, "a");
     const daemonEnv = {
       ...process.env,
@@ -879,7 +934,7 @@ function registerConnectCommand(program2) {
     };
     delete daemonEnv.CLAUDECODE;
     delete daemonEnv.CLAUDE_CODE_ENTRYPOINT;
-    const child = spawn(process.argv[0], [process.argv[1], "_daemon", agentName], {
+    const child = spawn(process.argv[0], [process.argv[1], "_daemon", key], {
       detached: true,
       stdio: ["ignore", logFd, logFd],
       cwd: meta.cwd,
@@ -890,13 +945,14 @@ function registerConnectCommand(program2) {
       pid: child.pid,
       cwd: meta.cwd,
       runtime: config2.runtime,
+      agentId: config2.agent_id,
       agentName: config2.agent_name,
       connectedAt: (/* @__PURE__ */ new Date()).toISOString(),
       claudePath
     };
-    writeFileSync(getMetaFile(agentName), JSON.stringify(newMeta, null, 2));
+    writeFileSync(getMetaFile(key), JSON.stringify(newMeta, null, 2));
     const runtimeDisplay = RUNTIME_NAMES[config2.runtime] || config2.runtime;
-    const home = homedir();
+    const home = homedir3();
     const shortCwd = meta.cwd.startsWith(home) ? "~" + meta.cwd.slice(home.length) : meta.cwd;
     const shortLog = logFile.startsWith(home) ? "~" + logFile.slice(home.length) : logFile;
     console.log("");
@@ -910,7 +966,9 @@ function registerConnectCommand(program2) {
 }
 
 // src/index.ts
-var program = new Command().name("bx").description("BoxCrew CLI \u2014 manage your agents from the terminal").version("0.1.0");
+var require2 = createRequire(import.meta.url);
+var { version } = require2("../package.json");
+var program = new Command().name("bx").description("BoxCrew CLI \u2014 manage your agents from the terminal").version(version);
 registerLoginCommand(program);
 registerLogoutCommand(program);
 registerAgentsCommands(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boxcrew/cli",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "BoxCrew CLI — manage your agents from the terminal",
   "type": "module",
   "bin": {