@todoforai/cli 0.1.15 → 0.1.16

package/README.md

@@ -6,11 +6,13 @@ CLI for [TODOforAI](https://todofor.ai) — create, watch, and inspect AI-powere
 
 ```bash
 bun install -g @todoforai/cli
+# Install the native bridge once, if it is not already on PATH:
+curl -fsSL https://raw.githubusercontent.com/todoforai/bridge/main/install.sh | sh
 ```
 
 ## Setup
 
-Just run `todoforai-cli` — on first use it opens a browser for **device login** and saves the API key to `~/.todoforai/credentials.json` (shared with the edge daemon).
+Just run `todoforai-cli` — on first use it opens a browser for **device login** and saves the CLI API key in the shared TODOforAI credentials file. The bridge uses the same file for its own device credentials.
 
 ```bash
 todoforai-cli                # prompts device login if no key found
@@ -19,15 +21,15 @@ todoforai-cli login          # explicit login
 
 API URL resolution: `--api-url` flag → `TODOFORAI_API_URL` env → `https://api.todofor.ai`.
 
-Auth resolution: `--api-key` flag → `TODOFORAI_API_KEY` env → shared credentials (`~/.todoforai/credentials.json`) → device login.
+Auth resolution: `--api-key` flag → `TODOFORAI_API_KEY` env → shared credentials file → device login.
 
 Project, agent, and last-todo state are stored **per API URL** under `per_api_url[<url>]` in the config — switching between e.g. `https://api.todofor.ai` and `http://localhost:4000` keeps each environment's defaults isolated. Legacy top-level fields are auto-migrated on first run.
 
-## Edge daemon
+## Bridge
 
-The CLI talks to the backend over WebSocket; **shell execution, file I/O, and tool calls happen in the edge daemon** running locally. On every run `todoforai-cli` spawns a detached edge process if none is running (PID-locked at `~/.todoforai/edge-<hash>.lock`, logs at `~/.todoforai/edge.log`). It keeps running after the CLI exits, so long-running tasks survive `Ctrl+D`.
+The CLI talks to the backend over WebSocket; **shell execution, file I/O, and tool calls happen in the bridge** running locally. On create/resume/template runs, `todoforai-cli` starts a detached `todoforai-bridge` process if needed (the bridge enforces its own single-instance lock, logs at `~/.todoforai/bridge.log`). If bridge credentials are missing, the CLI runs `todoforai-bridge login` in the foreground first so you can see and approve the device-login URL. The bridge keeps running after the CLI exits, so long-running tasks survive `Ctrl+D`.
 
-Disable with `--no-edge` if you manage the edge yourself (e.g. systemd, separate terminal).
+Disable with `--no-bridge` if you manage the bridge yourself (e.g. systemd, separate terminal). `--no-edge` remains supported as a deprecated alias.
 
 ## Usage
 
@@ -82,7 +84,8 @@ todoforai-cli --resume <todo-id>     # resume specific todo
 --dangerously-skip-permissions  Auto-approve all blocks (CI/benchmarks)
 --allow-all                     Set permissions to allow all tools (no approval needed)
 --no-watch                      Create todo and exit
---no-edge                       Do not auto-spawn edge daemon
+--no-bridge                     Do not auto-spawn bridge
+--no-edge                       Deprecated alias for --no-bridge
 --json                          Output as JSON
 --safe                          Validate API key upfront
 --debug, -d                     Debug output

package/dist/todoai.js

@@ -44008,7 +44008,8 @@ Options:
   --allow-all                     Set permissions to allow all tools (no approval needed)
   --raw-sysmsg <file>             Use file contents verbatim as system prompt (new TODO only)
   --no-watch                      Create todo and exit
-  --no-edge                       Do not auto-spawn edge daemon
+  --no-bridge                     Do not auto-spawn bridge
+  --no-edge                       Deprecated alias for --no-bridge
   --json                          Output as JSON
   --detailed                      'inspect --json': keep ids, timestamps, agentSettingsId, scheduledTimestamp
   --format-anthropic              'inspect --json': Anthropic-style shape (tool_result in next user msg); attachment sources are uri-typed, so not a 1:1 messages.create input
@@ -44062,6 +44063,7 @@ function parseCliArgs() {
       "allow-all": { type: "boolean", default: false },
       "raw-sysmsg": { type: "string" },
       "no-watch": { type: "boolean", default: false },
+      "no-bridge": { type: "boolean", default: false },
       "no-edge": { type: "boolean", default: false },
       json: { type: "boolean", default: false },
       detailed: { type: "boolean", default: false },
@@ -44077,6 +44079,8 @@ function parseCliArgs() {
     allowPositionals: true,
     strict: false
   });
+  if (values["no-edge"])
+    values["no-bridge"] = true;
   return { values, positionals };
 }
 
@@ -46118,30 +46122,91 @@ async function listTodosCommand(api, defaultProjectId, argv) {
 `);
 }
 
-// src/ensure-edge.ts
+// src/ensure-bridge.ts
 import { spawn, spawnSync } from "child_process";
 import fs2 from "fs";
 import path3 from "path";
 import os3 from "os";
-function hasBunx() {
-  const probe = spawnSync(process.platform === "win32" ? "where" : "which", ["bunx"], { stdio: "ignore" });
+function hasBridge() {
+  const probe = spawnSync("todoforai-bridge", ["--version"], { stdio: "ignore" });
   return probe.status === 0;
 }
-function ensureEdgeRunning(apiUrl, apiKey) {
-  if (!hasBunx()) {
-    console.error("\x1B[2mEdge daemon not started: `bunx` is missing. Install Bun from https://bun.sh to enable it, or pass --no-edge to silence this.\x1B[0m");
+function isLocalHost(hostname) {
+  return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1" || hostname === "[::1]";
+}
+function parseApiUrl(apiUrl) {
+  try {
+    return new URL(apiUrl);
+  } catch {
+    return null;
+  }
+}
+function bridgeProfile(apiUrl) {
+  const url = parseApiUrl(apiUrl);
+  if (!url)
+    return null;
+  if (isLocalHost(url.hostname))
+    return "dev";
+  if (!url.hostname || url.hostname === "api.todofor.ai")
+    return null;
+  return `api_${url.hostname.replace(/[^a-zA-Z0-9_]+/g, "_").replace(/^_+|_+$/g, "")}`;
+}
+function withProfile(args, apiUrl) {
+  const profile = bridgeProfile(apiUrl);
+  return profile ? [...args, "--profile", profile] : args;
+}
+function bridgeRunArgs(apiUrl) {
+  const url = parseApiUrl(apiUrl);
+  if (!url)
+    return [];
+  if (isLocalHost(url.hostname)) {
+    const args = ["--host", url.hostname];
+    if (url.port)
+      args.push("--port", url.port);
+    return withProfile(args, apiUrl);
+  }
+  if (url.hostname && url.hostname !== "api.todofor.ai")
+    return withProfile(["--host", url.hostname], apiUrl);
+  return [];
+}
+function bridgeLoginArgs(apiUrl) {
+  const url = parseApiUrl(apiUrl);
+  if (!url)
+    return ["login"];
+  if (url.hostname && url.hostname !== "api.todofor.ai")
+    return withProfile(["login", "--host", url.hostname], apiUrl);
+  return ["login"];
+}
+function bridgeWhoamiArgs(apiUrl) {
+  return withProfile(["whoami"], apiUrl);
+}
+function ensureBridgeCredentials(apiUrl) {
+  const whoami = spawnSync("todoforai-bridge", bridgeWhoamiArgs(apiUrl), { stdio: "ignore" });
+  if (whoami.status === 0)
+    return true;
+  console.error("\x1B[2mBridge credentials not found. Starting `todoforai-bridge login`...\x1B[0m");
+  const login = spawnSync("todoforai-bridge", bridgeLoginArgs(apiUrl), { stdio: "inherit" });
+  return login.status === 0;
+}
+function ensureBridgeRunning(apiUrl, _apiKey) {
+  if (!hasBridge()) {
+    console.error("\x1B[2mBridge not started: `todoforai-bridge` was not found on PATH. Install TODOforAI Bridge, or pass --no-bridge (or deprecated --no-edge) to silence this.\x1B[0m");
+    return;
+  }
+  if (!ensureBridgeCredentials(apiUrl)) {
+    console.error("\x1B[33mBridge not started: `todoforai-bridge login` did not complete successfully.\x1B[0m");
     return;
   }
   const logDir = path3.join(os3.homedir(), ".todoforai");
   fs2.mkdirSync(logDir, { recursive: true });
-  const logFile = path3.join(logDir, "edge.log");
+  const logFile = path3.join(logDir, "bridge.log");
   const out = fs2.openSync(logFile, "a");
-  const child = spawn("bunx", ["@todoforai/edge", "--api-url", apiUrl, "--api-key", apiKey], {
+  const child = spawn("todoforai-bridge", bridgeRunArgs(apiUrl), {
     detached: true,
     stdio: ["ignore", out, out]
   });
   child.on("error", (err) => {
-    console.error(`\x1B[33mFailed to start edge daemon: ${err.message}\x1B[0m`);
+    console.error(`\x1B[33mFailed to start bridge: ${err.message}\x1B[0m`);
   });
   let exited = false;
   let exitCode = null;
@@ -46156,13 +46221,13 @@ function ensureEdgeRunning(apiUrl, apiKey) {
   const shortLog = logFile.replace(os3.homedir(), "~");
   setTimeout(() => {
     if (!exited) {
-      console.error(`\x1B[2mStarted edge daemon (pid ${pid}), logs: ${shortLog}\x1B[0m`);
+      console.error(`\x1B[2mStarted bridge (pid ${pid}), logs: ${shortLog}\x1B[0m`);
       return;
     }
     if (exitCode === 0) {
-      console.error(`\x1B[2mEdge daemon exited cleanly (another instance likely already running). Logs: ${shortLog}\x1B[0m`);
+      console.error(`\x1B[2mBridge exited cleanly. Logs: ${shortLog}\x1B[0m`);
     } else {
-      console.error(`\x1B[31mEdge daemon died (exit ${exitCode}). Check logs: ${shortLog}\x1B[0m`);
+      console.error(`\x1B[33mBridge exited early (exit ${exitCode}). Check logs: ${shortLog}. Another instance may already be running.\x1B[0m`);
     }
   }, 500);
 }
@@ -46448,8 +46513,8 @@ Cancelled by user (Ctrl+C)
   if (process.stderr.isTTY)
     printLogo();
   if (args.template) {
-    if (!args["no-edge"] && !args["no-watch"])
-      ensureEdgeRunning(apiUrl, apiKey);
+    if (!args["no-bridge"] && !args["no-watch"])
+      ensureBridgeRunning(apiUrl, apiKey);
     const templateId = args.template;
     const inputValues = {};
     for (const kv of args.input || []) {
@@ -46536,8 +46601,8 @@ ${"\u2500".repeat(40)}
 `);
   }
   if (args.resume || args.continue) {
-    if (!args["no-edge"])
-      ensureEdgeRunning(apiUrl, apiKey);
+    if (!args["no-bridge"])
+      ensureBridgeRunning(apiUrl, apiKey);
     const todoId = args.resume || cfgScope.data.last_todo_id;
     if (!todoId) {
       process.stderr.write(`Error: No recent todo found
@@ -46622,8 +46687,8 @@ Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
   }
   process.stderr.write(`${DIM}Tip: ${randomTip()}${RESET}
 `);
-  if (!args["no-edge"] && !args["no-watch"])
-    ensureEdgeRunning(apiUrl, apiKey);
+  if (!args["no-bridge"] && !args["no-watch"])
+    ensureBridgeRunning(apiUrl, apiKey);
   let content;
   if (positionals.length > 0) {
     content = positionals.join(" ");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@todoforai/cli",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "type": "module",
   "bin": {
     "todoforai-cli": "dist/todoai.js",