@todoforai/cli 0.1.48 → 0.1.49

package/dist/todoforai-cli.js

@@ -44526,7 +44526,7 @@ import { parseArgs } from "util";
 // package.json
 var package_default = {
   name: "@todoforai/cli",
-  version: "0.1.48",
+  version: "0.1.49",
   type: "module",
   bin: {
     "todoforai-cli": "bin/todoforai-cli.js",
@@ -44568,45 +44568,35 @@ function getEnv(name) {
 }
 function printUsage() {
   process.stderr.write(`
-tfa-cli — TODOforAI CLI. Legacy aliases: todoforai-cli, todoai.
+tfa-cli — TODOforAI CLI
 
-Usage:
+Usage: tfa-cli [OPTIONS] ["prompt"]
+       tfa-cli [OPTIONS] <COMMAND> [ARGS]
+
+Examples:
   tfa-cli login                          # Browser-based device auth
-  tfa-cli "prompt text"                  # Prompt as argument
-  tfa-cli -n "Quick task"               # Non-interactive (run and exit)
-  echo "content" | tfa-cli              # Pipe from stdin
-  tfa-cli --path /my/project "Fix bug"  # Explicit workspace path
-  tfa-cli -c ["prompt"]                 # Resume last todo (optional prompt sent on attach)
-  tfa-cli --resume <todo-id> ["prompt"] # Resume specific todo (optional prompt sent on attach)
-  tfa-cli --inspect <todo-id>[@<slice>] # Read chat log. <slice> = -3:, :1, 5:10, 7  (Python-style)
-  tfa-cli start <id>                    # Start a TODO from the registry (todoregistry.com)
-  tfa-cli acp                           # Agent Client Protocol server on stdio (Zed, JetBrains, …; see README)
-  tfa-cli --list-agents                 # List available agents and exit
-  tfa-cli --list-models [filter]        # List models usable with --model and exit
-  tfa-cli agent update <agent> model=<model>    # Update agent settings (see 'agent --help'; also 'agent create')
-  tfa-cli todo set <todo-id|-> title=… group=… star=true   # Edit a todo's fields (see 'todo --help')
-  tfa-cli project set|settings|groups|default|agent …  # Edit the project, groups, defaults (see 'project --help')
-  tfa-cli brand list|create|select|voice …      # Brands (business contexts) + voice learning (see 'brand --help')
-  tfa-cli device list|rename|wallpaper …        # Paired machines (see 'device --help')
-  tfa-cli list [-n 30] [--cursor N] [--all] [--status S]  # List todos (paginated); see 'list --help'
-  tfa-cli status <todo-id> <STATUS>     # Update a todo's status (run 'status --help' for the full list)
+  tfa-cli "prompt text"                  # New todo
+  echo "content" | tfa-cli              # From stdin
+  tfa-cli start <id>                    # Registry template
+  tfa-cli acp                           # Agent Client Protocol (stdio)
+  tfa-cli agents                        # List agents
+  tfa-cli models [filter]               # Available models
+  tfa-cli agent list|get|update|create …        # Agents (update <agent> model=…)
+  tfa-cli todo set <todo-id|-> title=… group=… star=true   # Edit a todo's fields
+  tfa-cli project list|set|settings|groups|default|agent … # Projects; edit the current one
+  tfa-cli brand list|create|select|voice …      # Brands (business contexts) + voice learning
+  tfa-cli device list|rename|wallpaper …        # Paired machines
+  tfa-cli list [-n 30] [--cursor N] [--all] [--status S]  # List todos (paginated)
+  tfa-cli status <todo-id> <STATUS>     # Update a todo's status
   tfa-cli delete <todo-id>              # Permanently delete a todo
-  tfa-cli addmessage <todo-id> "text"  # Add a message to an existing todo
-  tfa-cli show <file|-> [todo-id]     # Show a file in the chat (rendered by mimetype; - reads stdin)
-                                            #   [--title T] [--alias A] [--mime M] [--card <name>] [--link] [--json]
-                                            #   --link = compact chip (name+size+download) instead of inline render
-                                            #   Prints "<todoId>:<alias|id>  <public url>". Re-showing with the same
-                                            #   --alias updates that block in place and pushes a new version to the
-                                            #   same url (older versions stay reachable at /<id>/<version>).
-  tfa-cli show rm <ref|alias>         # Take a shown file down (block, url, every version)
-  tfa-cli show list [todo-id]         # List show blocks (ref, title, mime/url, card)
-                                            #   [--project <id>] [--card <name>] [--json]
-                                            #   no todo-id + --project (or $TODOFORAI_PROJECT_ID) = every todo
-  tfa-cli open <url> [todo-id]        # Show a live http(s) url in the chat as a preview
-                                            #   [--title T] [--alias A] [--json]
-  tfa-cli recommend --template <id>    # Add a template as a recommendation card (see 'todoregistry-cli create')
-  tfa-cli claim mint --seed <projectId> [--emails a@x,b@y] [--ttl <sec>]  # Mint /claim/<token> ownership links for a project you own
-  tfa-cli next [--direction "<text>"]  # Ask the analyzer for growth recommendation cards (optional free-text steer)
+  tfa-cli addmessage <todo-id> "text"  # Send a message and exit (like -r, no watch/bridge)
+  tfa-cli show <file|-> [todo-id]     # Render a local file (image/pdf/html…) in the chat; - = stdin
+  tfa-cli show list|rm …              # List / take down shown files
+  tfa-cli open <url> [todo-id]        # Live url preview in the chat
+  tfa-cli recommend --template <id>    # Add a template as a recommendation card
+  tfa-cli claim mint --seed <projectId> [--emails a@x,b@y] [--ttl <sec>]  # Mint /claim/<token> links for a project you own
+  tfa-cli next [--direction "<text>"]  # Analyzer growth recommendation cards
+  tfa-cli <command> help                # Details per command
 
 Options:
   --path <dir>                    Workspace path (default: cwd)
@@ -44614,36 +44604,46 @@ Options:
   --agent, -a <name>              Agent name (partial match)
   --group <slug>                 Group new todo; omitted inherits TODOFORAI_GROUP_ID
   --group-name <name>            Display name for --group (last write wins)
-  --model <model>                 Override the agent's model for this todo
-                                  (e.g. anthropic:anthropic/claude-opus-5, openai:openai/gpt-5.6-sol)
-  --list-agents                   List available agents (name, id, workspace paths) and exit
-  --list-models                   List models usable with --model (optional substring filter) and exit
-  --api-url <url>                 API URL
-  --api-key <key>                 API key
+  --model <model>                 Model for this todo only (see 'models')
+  --api-url <url>
+  --api-key <key>
   --user-id <id>                  Admin HTTP impersonation; requires --no-watch
-  --inspect, -i <todo-id>[@<slice>]     Print chat log (read-only)
-  --template, -t <id> ["prompt"] Start from a registry template (alias: start <id>); prompt overrides the template task
-  --resume, -r [todo-id]          Resume existing todo
-  --continue, -c                  Continue most recent todo
-  --non-interactive, -n           Run to completion and exit without interactive prompt
-  --dangerously-skip-permissions  Auto-approve all blocks (for CI/benchmarks)
-  --allow-all                     Set permissions to allow all tools (no approval needed)
+  --inspect, -i <todo-id>[@<slice>]  Read chat log; slices: -3:, :1, 5:10, 7
+  --template, -t <id> ["prompt"]   Same as start; prompt overrides template task
+  --resume, -r <todo-id> ["prompt"]  Resume; optional follow-up
+  --continue, -c ["prompt"]       Resume last; optional follow-up
+  --non-interactive, -n           Run to completion, then exit
+  --dangerously-skip-permissions  CLI auto-approves every block
+  --allow-all                     Agent permissions allow:*:* — nothing ever asks
   --raw-sysmsg <file>             Use file contents verbatim as system prompt (new TODO only)
   --no-watch                      Create todo and exit
-  --isolated                      Spawn an ephemeral, task-scoped bridge: the agent sees ONLY
-                                  this machine (workspace = --path/cwd); session dies with the CLI
+  --isolated                      Agent sees ONLY this machine + dir (no cloud VM/other devices); ends with CLI
   --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
+  --json
+  --detailed | --format-anthropic  inspect --json: keep ids/timestamps | Anthropic messages shape
   --safe                          Validate API key upfront
-  --debug, -d                     Debug output
+  --debug, -d
   --debug-dump                    Attach LLM request debug info per turn (requires server grant)
-  --show-config                   Show config
-  --reset-config                  Reset config file
-  --version, -v                   Print version and exit
-  --help, -h                      Show this help
+  help | version | config         = -h | -v | --show-config   (--reset-config wipes it)
+`);
+}
+function printShowHelp() {
+  process.stderr.write(`
+tfa-cli show — put a file or url into the chat
+
+Usage:
+  tfa-cli show <file|-> [todo-id]     Render a file by mimetype (- reads stdin)
+                                      [--title T] [--alias A] [--mime M] [--card <name>] [--link] [--json]
+                                      --link: compact download chip instead of inline render
+                                      Prints "<todoId>:<alias|id>  <public url>". Re-showing with the same
+                                      --alias updates the block in place; old versions stay at /<id>/<version>
+  tfa-cli show rm <ref|alias>         Take it down (block, url, every version)
+  tfa-cli show list [todo-id]         List show blocks (ref, title, mime/url, card)
+                                      [--project <id>] [--card <name>] [--json]
+                                      no todo-id + --project (or $TODOFORAI_PROJECT_ID) = every todo
+  tfa-cli open <url> [todo-id]        Live http(s) url as a preview  [--title T] [--alias A] [--json]
+
+todo-id defaults to $TODOFORAI_TODO_ID (agent shell) or the last todo this CLI touched.
 `);
 }
 var STATUS_HELP = {
@@ -44667,6 +44667,14 @@ All valid statuses:
   ${Object.values(TodoStatus).join(", ")}
 `);
 }
+var WORD_FLAGS = {
+  help: "help",
+  version: "version",
+  models: "list-models",
+  agents: "list-agents",
+  config: "show-config"
+};
+var HELP_SUBCOMMANDS = ["agent", "todo", "project", "brand", "device", "list", "ls", "status", "show", "open"];
 function parseCliArgs() {
   const { values, positionals } = parseArgs({
     args: process.argv.slice(2),
@@ -44728,6 +44736,15 @@ function parseCliArgs() {
   });
   if (values["no-edge"])
     values["no-bridge"] = true;
+  const asFlag = !values["list-models"] && !values["list-agents"] && !values["show-config"] ? WORD_FLAGS[positionals[0]] : undefined;
+  if (asFlag) {
+    values[asFlag] = true;
+    positionals.shift();
+  }
+  if (positionals[1] === "help" && HELP_SUBCOMMANDS.includes(positionals[0])) {
+    values.help = true;
+    positionals.splice(1, 1);
+  }
   return { values, positionals };
 }
 
@@ -47644,6 +47661,7 @@ tfa-cli project — edit the current project
 --project <id> or $TODOFORAI_PROJECT_ID selects the project.
 
 Usage:
+  tfa-cli project list                             Projects you can access (* = default)
   tfa-cli project set <field=value>…               name=… description=… brand=<businessContextId>
                                                     (isPublic refused from an agent shell)
   tfa-cli project default                          Make it the project you land on at /
@@ -47725,6 +47743,19 @@ async function projectCommand(api, positionals, args) {
     printProjectHelp();
     process.exit(0);
   }
+  if (sub === "list" || sub === "ls") {
+    const projects = await api.listProjects();
+    if (args.json) {
+      console.log(JSON.stringify(projects, null, 2));
+      return;
+    }
+    for (const p of projects) {
+      const pr = p.project ?? p;
+      process.stderr.write(`${pr.isDefault ? "*" : " "} ${pr.name ?? ""}  ${DIM}${pr.id}${RESET}
+`);
+    }
+    return;
+  }
   if (!projectId)
     fail("No project — pass --project <id> or set TODOFORAI_PROJECT_ID");
   if (sub === "set") {
@@ -72552,6 +72583,16 @@ function formatPathWithTilde(path5) {
   const home = homedir3();
   return path5.startsWith(home) ? path5.replace(home, "~") : path5;
 }
+function promptArg(words) {
+  if (words.length === 0)
+    return;
+  if (words.length > 1 || !/\s/.test(words[0])) {
+    process.stderr.write(`${RED3}Error: "${words.join(" ")}" is not a subcommand, and a prompt must be ONE quoted argument, e.g. tfa-cli "fix the login bug" (or pipe it on stdin). Run tfa-cli --help for subcommands.${RESET2}
+`);
+    process.exit(2);
+  }
+  return words[0];
+}
 async function interactiveLoop(ws, api2, todoId, projectId, agent2, json2, autoApprove, cfg) {
   while (true) {
     try {
@@ -72653,6 +72694,10 @@ Cancelled by user (Ctrl+C)
     printStatusHelp();
     process.exit(0);
   }
+  if ((positionals[0] === "show" || positionals[0] === "open") && args.help) {
+    printShowHelp();
+    process.exit(0);
+  }
   if (positionals[0] === "agent" && args.help) {
     printAgentHelp();
     process.exit(0);
@@ -73143,7 +73188,7 @@ Cancelled by user (Ctrl+C)
       process.exit(1);
     }
     const promptWords = positionals[0] === "start" ? positionals.slice(2) : positionals;
-    const content2 = promptWords.join(" ").trim();
+    const content2 = (promptArg(promptWords) ?? "").trim();
     const todo2 = await api2.startFromSpec(projectId2, templateId, {
       ...content2 ? { content: content2 } : {},
       ...groupTag ? { groupTag } : {},
@@ -73218,7 +73263,7 @@ Resumed: ${CYAN2}${getFrontendUrl(apiUrl, todoId)}${RESET2}
     const ws2 = new FrontendWebSocket(apiUrl, apiKey);
     await ws2.connect();
     const autoApprove = !!args["dangerously-skip-permissions"];
-    const followUp = positionals.length > 0 ? positionals.join(" ") : process.stdin.isTTY ? "" : await readStdin();
+    const followUp = promptArg(positionals) ?? (process.stdin.isTTY ? "" : await readStdin());
     if (followUp) {
       cfg.addToHistory(followUp);
       await api2.addMessage(projectId2, followUp, agent3, todoId);
@@ -73236,11 +73281,7 @@ Resumed: ${CYAN2}${getFrontendUrl(apiUrl, todoId)}${RESET2}
 `);
     process.exit(2);
   }
-  if (positionals.length === 1 && !/\s/.test(positionals[0])) {
-    process.stderr.write(`${RED3}Error: "${positionals[0]}" is not a subcommand, and a prompt needs more than one word (or pipe it on stdin).${RESET2}
-`);
-    process.exit(2);
-  }
+  const argPrompt = promptArg(positionals);
   const ws = args["no-watch"] ? null : new FrontendWebSocket(apiUrl, apiKey);
   const wsReady = ws ? ws.connect() : null;
   const bridgeReady = !args["no-bridge"] && !args["no-watch"] && !args.isolated ? ensureBridgeRunning2(apiUrl, apiKey) : null;
@@ -73300,12 +73341,7 @@ Resumed: ${CYAN2}${getFrontendUrl(apiUrl, todoId)}${RESET2}
   }
   process.stderr.write(`${DIM2}Tip: ${randomTip()}${RESET2}
 `);
-  let content;
-  if (positionals.length > 0) {
-    content = positionals.join(" ");
-  } else {
-    content = await readStdin();
-  }
+  const content = argPrompt ?? await readStdin();
   const envProjectId = getEnv("PROJECT_ID");
   const hasProject = args.project || envProjectId || cfgScope.data.default_project_id;
   const storedAgent = cfgScope.data.default_agent_settings;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@todoforai/cli",
-  "version": "0.1.48",
+  "version": "0.1.49",
   "type": "module",
   "bin": {
     "todoforai-cli": "bin/todoforai-cli.js",