codex-to-im 0.1.1 → 0.1.2

package/README.md

@@ -92,6 +92,18 @@ If you forget the current address, run:
 codex-to-im url
 ```
 
+Check the current local service state:
+
+```bash
+codex-to-im status
+```
+
+Stop the background UI and bridge:
+
+```bash
+codex-to-im stop
+```
+
 ## Main Workflow
 
 1. Open the workbench
@@ -127,6 +139,18 @@ If creating a new session fails with `Not inside a trusted directory`, either:
 - change the default working directory to a trusted Git repo, or
 - enable `Allow Codex outside trusted Git repos` in the basic settings and restart the bridge
 
+## Update
+
+On Windows, `npm update -g codex-to-im` can fail with `EBUSY` if the background UI or bridge is still running from the global install directory.
+
+Recommended update flow:
+
+```bash
+codex-to-im stop
+npm update -g codex-to-im
+codex-to-im
+```
+
 ## Optional Codex Integration
 
 The repo still includes a lightweight optional integration under `SKILL.md`.

package/README_CN.md

@@ -92,6 +92,18 @@ http://127.0.0.1:4781
 codex-to-im url
 ```
 
+查看当前本地服务状态：
+
+```bash
+codex-to-im status
+```
+
+停止后台 UI 和 bridge：
+
+```bash
+codex-to-im stop
+```
+
 ## 主流程
 
 1. 打开工作台
@@ -127,6 +139,18 @@ codex-to-im url
 - 把默认工作目录改成一个你已经信任的 Git 仓库
 - 或在基础配置里打开“允许在未信任 Git 目录运行 Codex”，然后重启 Bridge
 
+## 更新
+
+Windows 上如果后台 UI 或 bridge 仍在运行，`npm update -g codex-to-im` 可能会因为安装目录被占用而报 `EBUSY`。
+
+推荐更新流程：
+
+```bash
+codex-to-im stop
+npm update -g codex-to-im
+codex-to-im
+```
+
 ## 可选 Codex 集成
 
 仓库里仍然保留了一个很薄的可选集成，定义在 `SKILL.md`。

package/dist/cli.mjs

@@ -42,6 +42,15 @@ function readJsonFile(filePath, fallback) {
     return fallback;
   }
 }
+function readPid(filePath) {
+  try {
+    const raw = fs2.readFileSync(filePath, "utf-8").trim();
+    const pid = Number(raw);
+    return Number.isFinite(pid) ? pid : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function isProcessAlive(pid) {
   if (!pid) return false;
   try {
@@ -62,6 +71,22 @@ function getCurrentUiServerUrl() {
   if (!status?.port) return void 0;
   return getUiServerUrl(status.port);
 }
+function getBridgeStatus() {
+  const status = readJsonFile(bridgeStatusFile, { running: false });
+  const pid = readPid(bridgePidFile) ?? status.pid;
+  if (!isProcessAlive(pid)) {
+    return {
+      ...status,
+      pid,
+      running: false
+    };
+  }
+  return {
+    ...status,
+    pid,
+    running: status.running ?? true
+  };
+}
 function getUiServerStatus() {
   const status = readJsonFile(uiStatusFile, { running: false, port: uiPort });
   if (!isProcessAlive(status.pid)) {
@@ -92,6 +117,33 @@ async function waitForUiServer(timeoutMs = 15e3) {
   }
   return getUiServerStatus();
 }
+async function stopBridge() {
+  const status = getBridgeStatus();
+  if (!status.pid || !isProcessAlive(status.pid)) {
+    return { ...status, running: false };
+  }
+  if (process.platform === "win32") {
+    await new Promise((resolve) => {
+      const killer = spawn("cmd", ["/c", "taskkill", "/PID", String(status.pid), "/T", "/F"], {
+        stdio: "ignore"
+      });
+      killer.on("exit", () => resolve());
+      killer.on("error", () => resolve());
+    });
+  } else {
+    try {
+      process.kill(status.pid, "SIGTERM");
+    } catch {
+    }
+  }
+  const startedAt = Date.now();
+  while (Date.now() - startedAt < 1e4) {
+    const next = getBridgeStatus();
+    if (!next.running) return next;
+    await sleep(300);
+  }
+  return getBridgeStatus();
+}
 async function ensureUiServerRunning() {
   ensureDirs();
   const current = getUiServerStatus();
@@ -118,6 +170,46 @@ async function ensureUiServerRunning() {
   }
   return status;
 }
+async function stopUiServer() {
+  const status = getUiServerStatus();
+  if (!status.pid || !isProcessAlive(status.pid)) {
+    const next2 = { ...status, running: false };
+    writeUiServerStatus(next2);
+    return next2;
+  }
+  if (process.platform === "win32") {
+    await new Promise((resolve) => {
+      const killer = spawn("cmd", ["/c", "taskkill", "/PID", String(status.pid), "/T", "/F"], {
+        stdio: "ignore"
+      });
+      killer.on("exit", () => resolve());
+      killer.on("error", () => resolve());
+    });
+  } else {
+    try {
+      process.kill(status.pid, "SIGTERM");
+    } catch {
+    }
+  }
+  const startedAt = Date.now();
+  while (Date.now() - startedAt < 1e4) {
+    const next2 = getUiServerStatus();
+    if (!next2.running) {
+      writeUiServerStatus({ ...next2, running: false });
+      return { ...next2, running: false };
+    }
+    await sleep(300);
+  }
+  const next = getUiServerStatus();
+  if (!next.running) {
+    writeUiServerStatus({ ...next, running: false });
+  }
+  return next;
+}
+function writeUiServerStatus(status) {
+  ensureDirs();
+  fs2.writeFileSync(uiStatusFile, JSON.stringify(status, null, 2), "utf-8");
+}
 function openBrowser(url) {
   if (process.platform === "win32") {
     const child2 = spawn("cmd", ["/c", "start", "", url], { detached: true, stdio: "ignore" });
@@ -171,8 +263,29 @@ async function main() {
 `);
       return;
     }
+    case "stop": {
+      const bridge = await stopBridge();
+      const ui = await stopUiServer();
+      process.stdout.write(
+        `Stopped services. UI running=${ui.running ? "yes" : "no"}, Bridge running=${bridge.running ? "yes" : "no"}
+`
+      );
+      return;
+    }
+    case "status": {
+      const ui = getUiServerStatus();
+      const bridge = getBridgeStatus();
+      const url = getCurrentUiServerUrl();
+      process.stdout.write(
+        [
+          `UI: ${ui.running ? "running" : "stopped"}${url ? ` (${url})` : ""}`,
+          `Bridge: ${bridge.running ? "running" : "stopped"}`
+        ].join("\n") + "\n"
+      );
+      return;
+    }
     default:
-      process.stdout.write("Usage: codex-to-im [open|url|share-feishu]\n");
+      process.stdout.write("Usage: codex-to-im [open|url|share-feishu|stop|status]\n");
   }
 }
 main().catch((error) => {

package/docs/install-windows.md

@@ -147,6 +147,18 @@ http://127.0.0.1:4781
 codex-to-im url
 ```
 
+查看当前本地服务状态：
+
+```powershell
+codex-to-im status
+```
+
+停止后台 UI 和 bridge：
+
+```powershell
+codex-to-im stop
+```
+
 ## 6. 在目标机上的首次配置
 
 进入本地工作台后，按这个顺序做：
@@ -271,6 +283,23 @@ codex-to-im url
 - 可选 Codex 集成不是主安装路径
 - 当前主路径是“本地工作台 + IM 配置 + Bridge 启动”
 
+## 10.1 Windows 上的更新方式
+
+如果后台 UI 或 bridge 仍在运行，Windows 可能会锁住 `%APPDATA%\\npm\\node_modules\\codex-to-im`，导致：
+
+- `npm update -g codex-to-im`
+- `npm uninstall -g codex-to-im`
+
+出现 `EBUSY` 或 `resource busy or locked`。
+
+推荐更新步骤：
+
+```powershell
+codex-to-im stop
+npm update -g codex-to-im
+codex-to-im
+```
+
 ## 11. 发布方注意事项
 
 如果你要把这个包发布到 npm，当前实现要求：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-to-im",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Installable Codex-to-IM bridge with local setup UI and background service",
   "license": "MIT",
   "type": "module",