@todoforai/cli 0.1.14 → 0.1.16

package/README.md

@@ -1,4 +1,4 @@
-# todoai CLI
+# todoforai-cli CLI
 
 CLI for [TODOforAI](https://todofor.ai) — create, watch, and inspect AI-powered todos.
 
@@ -6,46 +6,48 @@ 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 `todoai` — 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
-todoai                # prompts device login if no key found
-todoai login          # explicit login
+todoforai-cli                # prompts device login if no key found
+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 `todoai` 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
 
 ### Create a todo from a prompt
 
 ```bash
-todoai "Fix the login bug"
-todoai -n "Quick task"                    # non-interactive (run and exit)
-echo "content" | todoai                   # pipe from stdin
-todoai --path /my/project "Fix bug"       # explicit workspace
+todoforai-cli "Fix the login bug"
+todoforai-cli -n "Quick task"                    # non-interactive (run and exit)
+echo "content" | todoforai-cli                   # pipe from stdin
+todoforai-cli --path /my/project "Fix bug"       # explicit workspace
 ```
 
 ### Start from a registry template
 
 ```bash
-todoai --template alternativeto-listing                          # interactive input prompts
-todoai --template f5bot-monitoring-setup --input "monitoring_details=My Brand"  # with inputs
-todoai --template f5bot-monitoring-setup --no-watch --json       # create only
+todoforai-cli --template alternativeto-listing                          # interactive input prompts
+todoforai-cli --template f5bot-monitoring-setup --input "monitoring_details=My Brand"  # with inputs
+todoforai-cli --template f5bot-monitoring-setup --no-watch --json       # create only
 ```
 
 When inputs are missing, the CLI prompts interactively (unless `-n`).
@@ -53,7 +55,7 @@ When inputs are missing, the CLI prompts interactively (unless `-n`).
 ### Inspect a todo (read-only)
 
 ```bash
-todoai --inspect <todo-id>
+todoforai-cli --inspect <todo-id>
 ```
 
 Prints the full chat log: messages, tool calls (type, status, path/cmd), results, and errors. No logo, no interactive mode.
@@ -61,8 +63,8 @@ Prints the full chat log: messages, tool calls (type, status, path/cmd), results
 ### Resume / continue
 
 ```bash
-todoai -c                     # continue most recent todo
-todoai --resume <todo-id>     # resume specific todo
+todoforai-cli -c                     # continue most recent todo
+todoforai-cli --resume <todo-id>     # resume specific todo
 ```
 
 ## All Options
@@ -82,7 +84,8 @@ todoai --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

@@ -42752,6 +42752,27 @@ class ApiClient {
       throw new Error(`API ${method} ${endpoint} failed: ${res.status} ${await res.text()}`);
     return res.json();
   }
+  async trpcQuery(path2, input) {
+    const base = this.apiUrl.replace(/\/api\/v1\/?$/, "").replace(/\/$/, "");
+    const params = new URLSearchParams({
+      batch: "1",
+      input: JSON.stringify({ 0: input })
+    });
+    const res = await fetch(`${base}/trpc/api/${path2}?${params}`, {
+      method: "GET",
+      headers: this.headers,
+      signal: AbortSignal.timeout(30000)
+    });
+    const text = await res.text();
+    if (!res.ok)
+      throw new Error(`API tRPC ${path2} failed: ${res.status} ${text}`);
+    const payload = JSON.parse(text);
+    const item = Array.isArray(payload) ? payload[0] : payload;
+    if (item?.error)
+      throw new Error(`API tRPC ${path2} failed: ${item.error.message || JSON.stringify(item.error)}`);
+    const data = item?.result?.data;
+    return data?.json !== undefined ? data.json : data;
+  }
   async validateApiKey() {
     if (!this.apiKey)
       return { valid: false, error: "No API key provided" };
@@ -42790,9 +42811,10 @@ class ApiClient {
   createTodo(projectId, content, agentSettings) {
     return this.request("POST", `/api/v1/projects/${projectId}/todos`, { content, agentSettings });
   }
-  listTodos(projectId) {
-    const endpoint = projectId ? `/api/v1/projects/${projectId}/todos` : "/api/v1/todos";
-    return this.request("GET", endpoint);
+  listTodos(projectId, opts) {
+    if (!projectId)
+      return this.request("GET", "/api/v1/todos");
+    return this.trpcQuery("todo.list", { projectId, ...opts });
   }
   getTodo(todoId) {
     return this.request("GET", `/api/v1/todos/${todoId}`);
@@ -43107,8 +43129,8 @@ var package_default = {
   version: "0.1.3",
   type: "module",
   bin: {
-    todoai: "dist/todoai.js",
-    "todoforai-cli": "dist/todoai.js"
+    "todoforai-cli": "dist/todoai.js",
+    todoai: "dist/todoai.js"
   },
   files: ["dist/todoai.js"],
   scripts: {
@@ -43147,6 +43169,7 @@ var TodoStatus;
   TodoStatus2["POSTPONED"] = "POSTPONED";
   TodoStatus2["REVIEW_REQUESTED"] = "REVIEW_REQUESTED";
   TodoStatus2["RUNNING"] = "RUNNING";
+  TodoStatus2["WAITING_FOR_USER"] = "WAITING_FOR_USER";
   TodoStatus2["COMPACTING"] = "COMPACTING";
   TodoStatus2["STOPPING"] = "STOPPING";
   TodoStatus2["READY"] = "READY";
@@ -43451,6 +43474,15 @@ var SERVER_TO_FRONTENDS = {
   },
   functions: {}
 };
+// ../packages/shared-fbe/src/templateBody.ts
+var USER_HEADINGS = new Set([
+  "your task",
+  "your tasks",
+  "tasks",
+  "task",
+  "steps",
+  "data needed"
+]);
 // ../packages/shared-fbe/src/bashPatterns.ts
 function splitShellCommands(input) {
   const parts = [];
@@ -43940,24 +43972,24 @@ function getEnv(name) {
 }
 function printUsage() {
   process.stderr.write(`
-todoai \u2014 TODOforAI CLI (Bun)
+todoforai-cli \u2014 TODOforAI CLI (Bun)
 
 Usage:
-  todoai login                          # Browser-based device auth
-  todoai "prompt text"                  # Prompt as argument
-  todoai -n "Quick task"               # Non-interactive (run and exit)
-  echo "content" | todoai              # Pipe from stdin
-  todoai --path /my/project "Fix bug"  # Explicit workspace path
-  todoai -c ["prompt"]                 # Resume last todo (optional prompt sent on attach)
-  todoai --resume <todo-id> ["prompt"] # Resume specific todo (optional prompt sent on attach)
-  todoai --inspect <todo-id>[@<slice>] # Read chat log. <slice> = -3:, :1, 5:10, 7  (Python-style)
-  todoai --template <id> [--input k=v] # Start from a registry template
-  todoai --list-agents                 # List available agents and exit
-  todoai agent update <agent> model=<model>    # Update agent settings (see 'agent --help')
-  todoai list [-n 30] [--all] [--status S]   # List todos (open + recent first); see 'list --help'
-  todoai status <todo-id> <STATUS>     # Update a todo's status (run 'status --help' for the full list)
-  todoai delete <todo-id>              # Permanently delete a todo
-  todoai addmessage <todo-id> "text"  # Add a message to an existing todo
+  todoforai-cli login                          # Browser-based device auth
+  todoforai-cli "prompt text"                  # Prompt as argument
+  todoforai-cli -n "Quick task"               # Non-interactive (run and exit)
+  echo "content" | todoforai-cli              # Pipe from stdin
+  todoforai-cli --path /my/project "Fix bug"  # Explicit workspace path
+  todoforai-cli -c ["prompt"]                 # Resume last todo (optional prompt sent on attach)
+  todoforai-cli --resume <todo-id> ["prompt"] # Resume specific todo (optional prompt sent on attach)
+  todoforai-cli --inspect <todo-id>[@<slice>] # Read chat log. <slice> = -3:, :1, 5:10, 7  (Python-style)
+  todoforai-cli --template <id> [--input k=v] # Start from a registry template
+  todoforai-cli --list-agents                 # List available agents and exit
+  todoforai-cli agent update <agent> model=<model>    # Update agent settings (see 'agent --help')
+  todoforai-cli list [-n 30] [--cursor N] [--all] [--status S]  # List todos (paginated); see 'list --help'
+  todoforai-cli status <todo-id> <STATUS>     # Update a todo's status (run 'status --help' for the full list)
+  todoforai-cli delete <todo-id>              # Permanently delete a todo
+  todoforai-cli addmessage <todo-id> "text"  # Add a message to an existing todo
 
 Options:
   --path <dir>                    Workspace path (default: cwd)
@@ -43976,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
@@ -43999,7 +44032,7 @@ var STATUS_HELP = {
 };
 function printStatusHelp() {
   process.stderr.write(`
-todoai status <todo-id> <STATUS>
+todoforai-cli status <todo-id> <STATUS>
 
 Common statuses:
 ${Object.entries(STATUS_HELP).map(([s, d]) => `  ${s.padEnd(18)}${d}`).join(`
@@ -44030,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 },
@@ -44045,6 +44079,8 @@ function parseCliArgs() {
     allowPositionals: true,
     strict: false
   });
+  if (values["no-edge"])
+    values["no-bridge"] = true;
   return { values, positionals };
 }
 
@@ -45027,6 +45063,28 @@ function getItemId(item) {
     return item.project.id;
   return item?.id || "";
 }
+function resolveAgentMatch(agents, query) {
+  const byId = agents.find((a) => getItemId(a) === query);
+  if (byId)
+    return { match: byId };
+  const q = query.toLowerCase();
+  const esc = q.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const boundary = new RegExp(`\\b${esc}`);
+  const name = (a) => getDisplayName(a).toLowerCase();
+  const tiers = [
+    agents.filter((a) => name(a) === q),
+    agents.filter((a) => name(a).startsWith(q)),
+    agents.filter((a) => boundary.test(name(a))),
+    agents.filter((a) => name(a).includes(q))
+  ];
+  for (const tier of tiers) {
+    if (tier.length === 1)
+      return { match: tier[0] };
+    if (tier.length > 1)
+      return { ambiguous: tier };
+  }
+  return {};
+}
 function terminalLine(prompt) {
   const rl = createInterface2({ input: process.stdin, output: process.stderr });
   return new Promise((resolve3) => {
@@ -45758,12 +45816,12 @@ async function listAgentsCommand(api, opts) {
 // src/agent-command.ts
 function printAgentHelp() {
   process.stderr.write(`
-todoai agent \u2014 inspect and update agent settings
+todoforai-cli agent \u2014 inspect and update agent settings
 
 Usage:
-  todoai agent list                            List agents (name, model, id, paths)
-  todoai agent get <agent>                     Show a single agent's settings
-  todoai agent update <agent> <field=value>\u2026   Update one or more settings
+  todoforai-cli agent list                            List agents (name, model, id, paths)
+  todoforai-cli agent get <agent>                     Show a single agent's settings
+  todoforai-cli agent update <agent> <field=value>\u2026   Update one or more settings
 
 <agent> is a name or id (unique partial name also works).
 Fields map directly to agent settings; values are parsed as JSON when possible
@@ -45776,9 +45834,9 @@ Fields map directly to agent settings; values are parsed as JSON when possible
   name            agent display name
 
 Examples:
-  todoai agent update <agent> model=claude
-  todoai agent update <agent> model=anthropic:anthropic/claude-opus-4.8 temperature=0.5
-  todoai agent update <agent> sysmsg="You are a terse video editor."
+  todoforai-cli agent update <agent> model=claude
+  todoforai-cli agent update <agent> model=anthropic:anthropic/claude-opus-4.8 temperature=0.5
+  todoforai-cli agent update <agent> sysmsg="You are a terse video editor."
 `);
 }
 var FIELD_ALIASES = {
@@ -45804,20 +45862,13 @@ function parseAssignment(arg) {
   }
 }
 function resolveAgent(agents, query) {
-  const byId = agents.find((a) => getItemId(a) === query);
-  if (byId)
-    return byId;
-  const q = query.toLowerCase();
-  const exact = agents.filter((a) => getDisplayName(a).toLowerCase() === q);
-  if (exact.length === 1)
-    return exact[0];
-  const partial = agents.filter((a) => getDisplayName(a).toLowerCase().includes(q));
-  if (partial.length === 1)
-    return partial[0];
-  if (partial.length > 1) {
-    process.stderr.write(`${RED}Ambiguous agent '${query}', matches:${RESET}
+  const { match, ambiguous } = resolveAgentMatch(agents, query);
+  if (match)
+    return match;
+  if (ambiguous) {
+    process.stderr.write(`${RED}Ambiguous agent '${query}' \u2014 ${ambiguous.length} matches. Re-run with the exact id:${RESET}
 `);
-    for (const a of partial)
+    for (const a of ambiguous)
       process.stderr.write(`  ${getDisplayName(a)}  ${DIM}${getItemId(a)}${RESET}
 `);
     process.exit(2);
@@ -45853,7 +45904,7 @@ async function agentCommand(api, positionals, args, formatPath) {
     const query = positionals[2];
     const assignments = positionals.slice(3);
     if (!query || !assignments.length) {
-      process.stderr.write(`${RED}Usage: todoai agent update <name|id> <field=value>\u2026${RESET}
+      process.stderr.write(`${RED}Usage: todoforai-cli agent update <name|id> <field=value>\u2026${RESET}
 `);
       process.exit(2);
     }
@@ -45907,34 +45958,87 @@ var CLOSED = new Set([
 ]);
 var VALID_STATUS = new Set(Object.values(TodoStatus));
 var isOpen = (s) => !CLOSED.has(s);
-function printHelp() {
+function printListTodosHelp() {
   process.stderr.write(`
-todoai list \u2014 list todos in a project (recent first)
+todoforai-cli list \u2014 list todos in a project (recent first)
 
 Usage:
-  todoai list [flags]
+  todoforai-cli list [flags]
 
 Flags:
   -n, --limit <n>          Max rows to show (default: 30)
+      --cursor <n>         Fetch todos older than this cursor (lastActivityAt)
+      --page-size <n>      Backend page size per request (default: min(limit, 100), max: 100)
+      --search <text>      Search content/status on the backend
   -s, --status <S[,S2]>    Filter by status (comma-separated, union).
   -A, --all                Include DONE (also CANCELLED, ARCHIVED, \u2026)
       --project <id>       Project ID (default: current default project)
-      --json               Output raw JSON
+      --json               Output { items, nextCursor } as JSON
   -h, --help               Show this help
 
 Examples:
-  todoai list                       # 30 most recent open todos
-  todoai list -n 50                 # last 50 open
-  todoai list --all                 # include DONE
-  todoai list -s RUNNING,REVIEW_REQUESTED
-  todoai list --json | jq '.[].id'
+  todoforai-cli list                         # 30 most recent open todos
+  todoforai-cli list -n 50                   # last 50 open
+  todoforai-cli list --cursor 1719234567890  # next page
+  todoforai-cli list --all                   # include DONE
+  todoforai-cli list -s RUNNING,REVIEW_REQUESTED
+  todoforai-cli list --search bug --json | jq '.items[].id'
+`);
+}
+function positiveInt(value, name) {
+  if (value === undefined)
+    return;
+  const n = Number(value);
+  if (!Number.isFinite(n) || !Number.isInteger(n) || n < 1) {
+    process.stderr.write(`${RED}Error: ${name} must be a positive integer${RESET}
 `);
+    process.exit(2);
+  }
+  return n;
+}
+function cursorValue(value) {
+  if (value === undefined)
+    return;
+  const n = Number(value);
+  if (!Number.isFinite(n) || n < 0) {
+    process.stderr.write(`${RED}Error: --cursor must be a non-negative number${RESET}
+`);
+    process.exit(2);
+  }
+  return n;
+}
+function toItemsPage(response) {
+  if (Array.isArray(response))
+    return { items: response };
+  return {
+    items: Array.isArray(response?.items) ? response.items : [],
+    nextCursor: typeof response?.nextCursor === "number" ? response.nextCursor : undefined
+  };
+}
+function rowTime(t) {
+  return Number(t.lastActivityAt ?? t.createdAt ?? 0);
+}
+function printStatusError(unknown) {
+  process.stderr.write(`${RED}Error: unknown status ${unknown.map((s) => `'${s}'`).join(", ")}${RESET}
+`);
+  process.stderr.write(`${DIM}Use OPEN or one of: ${Object.values(TodoStatus).join(", ")}${RESET}
+`);
+  process.exit(2);
+}
+function matchesRequestedStatus(t, requested, wanted, wantOpen) {
+  if (!requested)
+    return true;
+  const s = String(t.status).toUpperCase();
+  return wantOpen && isOpen(s) || (wanted?.has(s) ?? false);
 }
 async function listTodosCommand(api, defaultProjectId, argv) {
   const { values } = parseArgs2({
     args: argv,
     options: {
       limit: { type: "string", short: "n" },
+      cursor: { type: "string" },
+      "page-size": { type: "string" },
+      search: { type: "string" },
       status: { type: "string", short: "s" },
       all: { type: "boolean", short: "A", default: false },
       project: { type: "string" },
@@ -45944,7 +46048,7 @@ async function listTodosCommand(api, defaultProjectId, argv) {
     strict: true
   });
   if (values.help) {
-    printHelp();
+    printListTodosHelp();
     return;
   }
   const projectId = values.project || defaultProjectId;
@@ -45953,65 +46057,156 @@ async function listTodosCommand(api, defaultProjectId, argv) {
 `);
     process.exit(1);
   }
-  const limit = values.limit ? Math.max(1, Number(values.limit)) : 30;
+  const limit = positiveInt(values.limit, "--limit") ?? 30;
+  const pageSize = Math.min(positiveInt(values["page-size"], "--page-size") ?? Math.min(Math.max(limit, 1), 100), 100);
+  let cursor = cursorValue(values.cursor);
+  const search = values.search ? String(values.search) : undefined;
   const requested = values.status ? String(values.status).split(",").map((s) => s.trim().toUpperCase()).filter(Boolean) : null;
-  const wantOpen = !!requested?.some((s) => s === "OPEN" || !VALID_STATUS.has(s));
+  const unknown = requested?.filter((s) => s !== "OPEN" && !VALID_STATUS.has(s)) ?? [];
+  if (unknown.length)
+    printStatusError(unknown);
+  const wantOpen = !!requested?.some((s) => s === "OPEN");
   const wanted = requested ? new Set(requested.filter((s) => VALID_STATUS.has(s))) : null;
   const includeClosed = !!values.all || !!wanted && wanted.size > 0;
-  const todos = await api.listTodos(projectId);
-  let rows = todos.filter((t) => includeClosed || !CLOSED.has(String(t.status).toUpperCase())).filter((t) => {
-    if (!requested)
-      return true;
-    const s = String(t.status).toUpperCase();
-    return wantOpen && isOpen(s) || (wanted?.has(s) ?? false);
-  }).sort((a, b) => (b.lastActivityAt ?? b.createdAt ?? 0) - (a.lastActivityAt ?? a.createdAt ?? 0)).slice(0, limit);
+  const rows = [];
+  let backendNextCursor;
+  while (rows.length < limit) {
+    const requestLimit = Math.min(pageSize, limit - rows.length);
+    const page = toItemsPage(await api.listTodos(projectId, { limit: requestLimit, cursor, search }));
+    backendNextCursor = page.nextCursor;
+    for (const t of page.items) {
+      const status = String(t.status).toUpperCase();
+      if (!includeClosed && CLOSED.has(status))
+        continue;
+      if (!matchesRequestedStatus(t, requested, wanted, wantOpen))
+        continue;
+      rows.push(t);
+      if (rows.length >= limit)
+        break;
+    }
+    if (!backendNextCursor || page.items.length === 0)
+      break;
+    cursor = backendNextCursor;
+  }
+  rows.sort((a, b) => rowTime(b) - rowTime(a));
+  const visible = rows.slice(0, limit);
+  const hasBufferedRows = rows.length > visible.length;
+  const nextCursor = visible.length && (backendNextCursor !== undefined || hasBufferedRows) ? rowTime(visible[visible.length - 1]) : undefined;
   if (values.json) {
-    process.stdout.write(JSON.stringify(rows, null, 2) + `
+    process.stdout.write(JSON.stringify({ items: visible, nextCursor }, null, 2) + `
 `);
     return;
   }
-  if (!rows.length) {
+  if (!visible.length) {
     process.stderr.write(`${DIM}(no todos)${RESET}
+`);
+    if (nextCursor !== undefined)
+      process.stderr.write(`${DIM}Next cursor: ${nextCursor} (re-run with the same filters plus --cursor ${nextCursor})${RESET}
 `);
     return;
   }
-  const statusW = rows.reduce((n, r) => Math.max(n, String(r.status).length), 0);
-  for (const t of rows) {
-    const sc = STATUS_COLOR[t.status] || DIM;
-    const ts = new Date(t.lastActivityAt ?? t.createdAt).toISOString().slice(0, 16).replace("T", " ");
+  const statusW = visible.reduce((n, r) => Math.max(n, String(r.status).length), 0);
+  for (const t of visible) {
+    const status = String(t.status).toUpperCase();
+    const sc = STATUS_COLOR[status] || DIM;
+    const ts = new Date(rowTime(t)).toISOString().slice(0, 16).replace("T", " ");
     const title = String(t.content ?? "").split(`
 `)[0].slice(0, 100);
-    process.stdout.write(`${sc}${String(t.status).padEnd(statusW)}${RESET}  ${DIM}${ts}${RESET}  ${t.id}  ${title}
+    process.stdout.write(`${sc}${status.padEnd(statusW)}${RESET}  ${DIM}${ts}${RESET}  ${t.id}  ${title}
 `);
   }
-  process.stderr.write(`${DIM}${rows.length} todo(s)${RESET}
+  process.stderr.write(`${DIM}${visible.length} todo(s)${RESET}
+`);
+  if (nextCursor !== undefined)
+    process.stderr.write(`${DIM}Next cursor: ${nextCursor} (re-run with the same filters plus --cursor ${nextCursor})${RESET}
 `);
 }
 
-// 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;
@@ -46026,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);
 }
@@ -46139,6 +46334,10 @@ Cancelled by user (Ctrl+C)
     printAgentHelp();
     process.exit(0);
   }
+  if ((positionals[0] === "list" || positionals[0] === "ls") && args.help) {
+    printListTodosHelp();
+    process.exit(0);
+  }
   if (args.help && !["list", "ls", "agent"].includes(positionals[0])) {
     printUsage();
     process.exit(0);
@@ -46234,7 +46433,7 @@ Cancelled by user (Ctrl+C)
   if (positionals[0] === "delete") {
     const todoId = positionals[1];
     if (!todoId) {
-      process.stderr.write(`${RED}Usage: todoai delete <todo-id>${RESET}
+      process.stderr.write(`${RED}Usage: todoforai-cli delete <todo-id>${RESET}
 `);
       process.exit(2);
     }
@@ -46247,7 +46446,7 @@ Cancelled by user (Ctrl+C)
     const [, todoId, ...rest] = positionals;
     const content2 = rest.join(" ") || await readStdin();
     if (!todoId || !content2) {
-      process.stderr.write(`${RED}Usage: todoai addmessage <todo-id> "content"${RESET}
+      process.stderr.write(`${RED}Usage: todoforai-cli addmessage <todo-id> "content"${RESET}
 `);
       process.exit(2);
     }
@@ -46314,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 || []) {
@@ -46402,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
@@ -46440,14 +46639,22 @@ Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
   let preMatchedAgent = null;
   let agents = null;
   if (args.agent) {
-    const matches = await api.listAgentSettings({ name: args.agent });
-    if (matches.length > 0) {
-      preMatchedAgent = matches[0];
-    } else {
+    agents = await api.listAgentSettings();
+    const { match, ambiguous } = resolveAgentMatch(agents, args.agent);
+    if (ambiguous) {
+      process.stderr.write(`Error: Ambiguous agent '${args.agent}' \u2014 ${ambiguous.length} matches. Re-run with the exact id:
+`);
+      for (const a of ambiguous)
+        process.stderr.write(`  ${getDisplayName(a)}  ${DIM}${getItemId(a)}${RESET}
+`);
+      process.exit(1);
+    }
+    if (!match) {
       process.stderr.write(`Error: Agent '${args.agent}' not found
 `);
       process.exit(1);
     }
+    preMatchedAgent = match;
     cfgScope.setDefaultAgent(getDisplayName(preMatchedAgent), preMatchedAgent);
   } else {
     const pathArg = args.path || ".";
@@ -46480,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,10 +1,10 @@
 {
   "name": "@todoforai/cli",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "type": "module",
   "bin": {
-    "todoai": "dist/todoai.js",
-    "todoforai-cli": "dist/todoai.js"
+    "todoforai-cli": "dist/todoai.js",
+    "todoai": "dist/todoai.js"
   },
   "files": [
     "dist/todoai.js"