@todoforai/cli 0.1.47 → 0.1.49

package/dist/todoforai-cli.js

@@ -42860,6 +42860,75 @@ class ApiClient {
   deleteTodo(todoId) {
     return this.request("DELETE", `/api/v1/todos/${todoId}`);
   }
+  restoreTodo(todoId) {
+    return this.request("POST", `/api/v1/todos/${todoId}/restore`, { todoId });
+  }
+  reorderAgentSettings(agentSettingsIds) {
+    return this.request("PUT", "/api/v1/agents/reorder", { agentSettingsIds });
+  }
+  updateTodo(todoId, updates) {
+    return this.request("PUT", `/api/v1/todos/${todoId}`, { todoId, ...updates });
+  }
+  updateScheduledMessage(todoId, messageId, agentSettingsId, updates) {
+    return this.request("PATCH", `/api/v1/todos/${todoId}/messages/${messageId}`, { todoId, messageId, agentSettingsId, ...updates });
+  }
+  setDefaultProject(projectId) {
+    return this.request("POST", "/api/v1/users/default-project", { projectId });
+  }
+  setProjectDefaultAgent(projectId, agentSettingsId) {
+    return this.request("POST", "/api/v1/users/project-agent-mapping", { projectId, agentSettingsId });
+  }
+  renameDevice(id, name) {
+    return this.request("PATCH", `/api/v1/devices/${id}/name`, { id, name });
+  }
+  setDeviceWallpaperMode(id, mode) {
+    return this.request("POST", `/api/v1/devices/${id}/wallpaper-mode`, { id, mode });
+  }
+  listBusinessContexts() {
+    return this.request("GET", "/api/v1/business-context");
+  }
+  createBusinessContext(name) {
+    return this.request("POST", "/api/v1/business-context", { name });
+  }
+  renameBusinessContext(id, name) {
+    return this.request("PUT", `/api/v1/business-context/${id}`, { id, name });
+  }
+  selectBusinessContext(contextId) {
+    return this.request("POST", "/api/v1/business-context/select", { contextId });
+  }
+  listVoiceSources(businessContextId) {
+    return this.request("GET", `/api/v1/business-context/voice-sources?id=${encodeURIComponent(businessContextId)}`);
+  }
+  collectVoiceSource(businessContextId, channel, opts) {
+    return this.request("POST", "/api/v1/business-context/collect-voice-source", { businessContextId, channel, ...opts });
+  }
+  removeVoiceSource(businessContextId, channel) {
+    return this.request("POST", "/api/v1/business-context/remove-voice-source", { businessContextId, channel });
+  }
+  refineBrandVoice(businessContextId, answers, source) {
+    return this.request("POST", "/api/v1/business-context/refine-brand-voice", { businessContextId, answers, ...source && { source } });
+  }
+  getProfile() {
+    return this.request("GET", "/api/v1/users/profile");
+  }
+  getOnboarding() {
+    return this.request("GET", "/api/v1/onboarding");
+  }
+  patchOnboarding(patch) {
+    return this.request("PUT", "/api/v1/onboarding", { patch });
+  }
+  updateProject(projectId, updates) {
+    return this.request("PUT", `/api/v1/projects/${projectId}`, { projectId, ...updates });
+  }
+  listProjectGroups(projectId) {
+    return this.request("GET", `/api/v1/projects/${projectId}/groups`);
+  }
+  upsertProjectGroup(projectId, slug, fields) {
+    return this.request("PUT", `/api/v1/projects/${projectId}/groups/${encodeURIComponent(slug)}`, { projectId, slug, ...fields });
+  }
+  reorderProjectGroups(projectId, slugs) {
+    return this.request("PUT", `/api/v1/projects/${projectId}/groups-order`, { projectId, slugs });
+  }
   listModels() {
     return this.request("GET", "/api/v1/models");
   }
@@ -43669,6 +43738,9 @@ var SERVER_TO_FRONTENDS = {
   notification: {
     changed: (userId) => `${"notification:changed" /* NOTIFICATION_CHANGED */}:${userId}`
   },
+  frontend: {
+    presence: (userId) => `${"frontend:presence" /* FRONTEND_PRESENCE */}:${userId}`
+  },
   agent: {
     status: (userId) => `${"agent:status" /* AGENT_STATUS */}:${userId}`,
     mcpList: () => `${"agent:mcp_list" /* AGENT_MCP_LIST */}:ALL`
@@ -44334,6 +44406,10 @@ var TOPICS = {
     channel: (p) => SERVER_TO_FRONTENDS.notification.changed(p.userId),
     audience: "frontend"
   },
+  ["frontend:presence" /* FRONTEND_PRESENCE */]: {
+    channel: (p) => SERVER_TO_FRONTENDS.frontend.presence(p.userId),
+    audience: "frontend"
+  },
   ["NOTIFY" /* NOTIFY */]: {
     channel: (p) => p.userId ? SERVER_TO_FRONTENDS.notify.user(p.userId) : SERVER_TO_FRONTENDS.todo.notify(p.todoId),
     audience: "frontend"
@@ -44450,7 +44526,7 @@ import { parseArgs } from "util";
 // package.json
 var package_default = {
   name: "@todoforai/cli",
-  version: "0.1.47",
+  version: "0.1.49",
   type: "module",
   bin: {
     "todoforai-cli": "bin/todoforai-cli.js",
@@ -44492,41 +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')
-  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)
@@ -44534,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 = {
@@ -44587,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),
@@ -44614,6 +44702,10 @@ function parseCliArgs() {
       link: { type: "boolean", default: false },
       direction: { type: "string" },
       "business-context": { type: "string" },
+      brand: { type: "string" },
+      url: { type: "string" },
+      "pasted-file": { type: "string" },
+      "from-company": { type: "boolean", default: false },
       seed: { type: "string" },
       emails: { type: "string" },
       ttl: { type: "string" },
@@ -44644,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 };
 }
 
@@ -47290,6 +47391,9 @@ Usage:
   tfa-cli agent list                            List agents (name, model, id, paths)
   tfa-cli agent get <agent>                     Show a single agent's settings
   tfa-cli agent update <agent> <field=value>…   Update one or more settings
+  tfa-cli agent create [<field=value>…]         Create an agent (defaults, then apply fields)
+  tfa-cli agent global [<field=value>…]         Show / update the user's global agent defaults
+  tfa-cli agent reorder <agent>…                Set the sidebar order (names or ids)
   tfa-cli agent delete <agent>                  Delete an agent configuration (asks to confirm)
 
 <agent> is a name or id (unique partial name also works).
@@ -47306,6 +47410,10 @@ Examples:
   tfa-cli agent update <agent> model=claude
   tfa-cli agent update <agent> model=anthropic:anthropic/claude-opus-5 temperature=0.5
   tfa-cli agent update <agent> sysmsg="You are a terse video editor."
+  tfa-cli agent create name=Reviewer model=claude sysmsg="Review diffs only."
+
+From an agent shell (dst_ token) permissions, mcpConfigs, edgesMcpConfigs,
+devicesConfig and delete are refused by the backend.
 `);
 }
 var FIELD_ALIASES = {
@@ -47314,7 +47422,7 @@ var FIELD_ALIASES = {
   temp: "temperature",
   thinking: "thinkingLevel"
 };
-function parseAssignment(arg) {
+function parseAssignment(arg, aliases = {}) {
   const eq = arg.indexOf("=");
   if (eq < 1) {
     process.stderr.write(`${RED}Invalid field assignment '${arg}', expected field=value${RESET}
@@ -47322,7 +47430,7 @@ function parseAssignment(arg) {
     process.exit(2);
   }
   const rawKey = arg.slice(0, eq);
-  const key = FIELD_ALIASES[rawKey] || rawKey;
+  const key = aliases[rawKey] || rawKey;
   const raw = arg.slice(eq + 1);
   try {
     return [key, JSON.parse(raw)];
@@ -47330,6 +47438,9 @@ function parseAssignment(arg) {
     return [key, raw];
   }
 }
+function parseAssignments(args, aliases = {}) {
+  return Object.fromEntries(args.map((a) => parseAssignment(a, aliases)));
+}
 function resolveAgent(agents, query) {
   const { match, ambiguous } = resolveAgentMatch2(agents, query);
   if (match)
@@ -47377,7 +47488,7 @@ async function agentCommand(api, positionals, args, formatPath) {
 `);
       process.exit(2);
     }
-    const updates = Object.fromEntries(assignments.map(parseAssignment));
+    const updates = parseAssignments(assignments, FIELD_ALIASES);
     const agents = await api.listAgentSettings();
     const agent = resolveAgent(agents, query);
     const id = getItemId2(agent);
@@ -47388,6 +47499,45 @@ async function agentCommand(api, positionals, args, formatPath) {
     }
     const summary = Object.keys(updates).map((k) => `${k}=${JSON.stringify(updated[k])}`).join(" ");
     process.stderr.write(`${GREEN}✅ ${getDisplayName2(agent)} updated: ${summary}${RESET}
+`);
+    return;
+  }
+  if (sub === "global") {
+    const updates = parseAssignments(positionals.slice(2), FIELD_ALIASES);
+    const global = Object.keys(updates).length ? await api.updateGlobalAgentSettings(updates) : await api.getGlobalAgentSettings();
+    if (args.json) {
+      console.log(JSON.stringify(global, null, 2));
+      return;
+    }
+    for (const [k, v] of Object.entries(global))
+      process.stderr.write(`  ${DIM}${k}:${RESET} ${typeof v === "string" ? v : JSON.stringify(v)}
+`);
+    return;
+  }
+  if (sub === "reorder") {
+    const queries = positionals.slice(2);
+    if (!queries.length) {
+      process.stderr.write(`${RED}Usage: tfa-cli agent reorder <agent>…${RESET}
+`);
+      process.exit(2);
+    }
+    const agents = await api.listAgentSettings();
+    const ids = queries.map((q) => getItemId2(resolveAgent(agents, q)));
+    await api.reorderAgentSettings(ids);
+    process.stderr.write(`${GREEN}✅ Agents reordered${RESET}
+`);
+    return;
+  }
+  if (sub === "create") {
+    const updates = parseAssignments(positionals.slice(2), FIELD_ALIASES);
+    const created = await api.createAgent();
+    const id = getItemId2(created);
+    const agent = Object.keys(updates).length ? await api.updateAgentSettings(id, id, updates) : created;
+    if (args.json) {
+      console.log(JSON.stringify(agent, null, 2));
+      return;
+    }
+    process.stderr.write(`${GREEN}✅ Created agent ${getDisplayName2(agent)}${RESET}  ${DIM}${id}${RESET}
 `);
     return;
   }
@@ -47423,6 +47573,507 @@ async function agentCommand(api, positionals, args, formatPath) {
   process.exit(2);
 }
 
+// src/agent-command.ts
+function parseAssignment2(arg, aliases = {}) {
+  const eq = arg.indexOf("=");
+  if (eq < 1) {
+    process.stderr.write(`${RED}Invalid field assignment '${arg}', expected field=value${RESET}
+`);
+    process.exit(2);
+  }
+  const rawKey = arg.slice(0, eq);
+  const key = aliases[rawKey] || rawKey;
+  const raw = arg.slice(eq + 1);
+  try {
+    return [key, JSON.parse(raw)];
+  } catch {
+    return [key, raw];
+  }
+}
+function parseAssignments2(args, aliases = {}) {
+  return Object.fromEntries(args.map((a) => parseAssignment2(a, aliases)));
+}
+function resolveAgent2(agents, query) {
+  const { match, ambiguous } = resolveAgentMatch2(agents, query);
+  if (match)
+    return match;
+  if (ambiguous) {
+    process.stderr.write(`${RED}Ambiguous agent '${query}' — ${ambiguous.length} matches. Re-run with the exact id:${RESET}
+`);
+    for (const a of ambiguous)
+      process.stderr.write(`  ${getDisplayName2(a)}  ${DIM}${getItemId2(a)}${RESET}
+`);
+    process.exit(2);
+  }
+  process.stderr.write(`${RED}No agent matching '${query}'${RESET}
+`);
+  process.exit(2);
+}
+
+// src/args.ts
+var VERSION2 = package_default.version;
+function getEnv2(name) {
+  return (process.env[`TODOFORAI_${name}`] || process.env[`TODO4AI_${name}`] || "").trim();
+}
+var STATUS_HELP2 = {
+  ["READY" /* READY */]: "AI finished the work on the TODO",
+  ["READY_CHECKED" /* READY_CHECKED */]: "AI finished and the user reviewed it",
+  ["DONE" /* DONE */]: "Completed and finalized",
+  ["REVIEW_REQUESTED" /* REVIEW_REQUESTED */]: "Asks the user to review",
+  ["POSTPONED" /* POSTPONED */]: "Put off for later",
+  ["ARCHIVED" /* ARCHIVED */]: "Archived (hidden from active list)",
+  ["DELETED" /* DELETED */]: "Marked for deletion"
+};
+
+// src/manage-command.ts
+function printTodoHelp() {
+  process.stderr.write(`
+tfa-cli todo — edit a todo's fields
+
+Usage:
+  tfa-cli todo set <todo-id|-> <field=value>…   Update fields ("-" = $TODOFORAI_TODO_ID)
+  tfa-cli todo restore <todo-id>                Bring a trashed todo back (undo of 'delete')
+
+Fields (PUT /todos/{id}):
+  title            first-line content (alias: content)
+  group            group slug; "" makes it ungrouped (alias: groupTag)
+  star             true|false (starredAt now / 0)
+  schedule         unix ms timestamp, 0 = immediate (alias: scheduledTimestamp)
+  agent            agentSettingsId (alias: agentSettingsId)
+  brand            businessContextId (alias: businessContextId)
+  public           true|false — refused from an agent shell (isPublic)
+
+  tfa-cli todo message <todo-id|-> <message-id> <field=value>…
+                   Edit a SCHEDULED (not yet run) message: content, schedule (unix ms;
+                   0 = run now). Runs with the todo's own agent.
+
+Examples:
+  tfa-cli todo set - title="Ship v2 landing" group=marketing
+  tfa-cli todo set 3f2a91 star=true
+  tfa-cli todo message - 8c1d… schedule=1760000000000
+  tfa-cli status <todo-id> DONE                  (status has its own command)
+`);
+}
+function printProjectHelp() {
+  process.stderr.write(`
+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 /
+  tfa-cli project agent <agent>                    Default agent for new todos in this project
+  tfa-cli project settings <field=value>…          Project settings (PUT /settings/projects/{id})
+  tfa-cli project groups                           List todo groups
+  tfa-cli project groups set <slug> <field=value>… Create/update a group: name description pinned archived order
+  tfa-cli project groups reorder <slug>…           Set wall order
+
+Examples:
+  tfa-cli project set name="Q4 launch"
+  tfa-cli project groups set marketing name=Marketing description="Top-of-funnel work"
+  tfa-cli project groups reorder marketing sales ops
+`);
+}
+var TODO_ALIASES = {
+  title: "content",
+  group: "groupTag",
+  schedule: "scheduledTimestamp",
+  agent: "agentSettingsId",
+  brand: "businessContextId",
+  public: "isPublic"
+};
+var PROJECT_ALIASES = { brand: "businessContextId" };
+function fail(msg) {
+  process.stderr.write(`${RED}${msg}${RESET}
+`);
+  process.exit(2);
+}
+async function todoCommand(api, positionals, args) {
+  const [, sub, idArg, ...rest] = positionals;
+  if (sub === "restore") {
+    if (!idArg)
+      fail("Usage: tfa-cli todo restore <todo-id>");
+    await api.restoreTodo(idArg);
+    process.stderr.write(`${GREEN}✅ Restored ${idArg}${RESET}
+`);
+    return;
+  }
+  const todoId = !idArg || idArg === "-" ? getEnv2("TODO_ID") : idArg;
+  if (sub === "message") {
+    const [messageId, ...fields] = rest;
+    if (!todoId || !messageId || !fields.length)
+      fail("Usage: tfa-cli todo message <todo-id|-> <message-id> <field=value>…");
+    const updates2 = parseAssignments2(fields, { schedule: "scheduledTimestamp" });
+    const agentSettingsId = (await api.getTodo(todoId))?.agentSettingsId;
+    if (!agentSettingsId)
+      fail("Todo has no agent assigned");
+    await api.updateScheduledMessage(todoId, messageId, agentSettingsId, updates2);
+    process.stderr.write(`${GREEN}✅ message ${messageId} updated: ${Object.keys(updates2).join(", ")}${RESET}
+`);
+    return;
+  }
+  if (sub !== "set") {
+    printTodoHelp();
+    process.exit(sub ? 2 : 0);
+  }
+  if (!todoId || !rest.length)
+    fail("Usage: tfa-cli todo set <todo-id|-> <field=value>…");
+  const updates = parseAssignments2(rest, TODO_ALIASES);
+  if ("star" in updates) {
+    if (typeof updates.star !== "boolean")
+      fail("star must be true or false");
+    updates.starredAt = updates.star ? Date.now() : 0;
+    delete updates.star;
+  }
+  await api.updateTodo(todoId, updates);
+  if (args.json) {
+    console.log(JSON.stringify({ todoId, ...updates }));
+    return;
+  }
+  process.stderr.write(`${GREEN}✅ ${todoId} updated: ${Object.keys(updates).join(", ")}${RESET}
+`);
+}
+async function projectCommand(api, positionals, args) {
+  const [, sub, ...rest] = positionals;
+  const projectId = args.project || getEnv2("PROJECT_ID");
+  if (!sub) {
+    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") {
+    if (!rest.length)
+      fail("Usage: tfa-cli project set <field=value>…");
+    const updates = parseAssignments2(rest, PROJECT_ALIASES);
+    await api.updateProject(projectId, updates);
+    process.stderr.write(`${GREEN}✅ project updated: ${Object.keys(updates).join(", ")}${RESET}
+`);
+    return;
+  }
+  if (sub === "default") {
+    await api.setDefaultProject(projectId);
+    process.stderr.write(`${GREEN}✅ ${projectId} is now the default project${RESET}
+`);
+    return;
+  }
+  if (sub === "agent") {
+    if (!rest[0])
+      fail("Usage: tfa-cli project agent <agent>");
+    const agent = resolveAgent2(await api.listAgentSettings(), rest[0]);
+    await api.setProjectDefaultAgent(projectId, getItemId2(agent));
+    process.stderr.write(`${GREEN}✅ default agent for ${projectId}: ${getDisplayName2(agent)}${RESET}
+`);
+    return;
+  }
+  if (sub === "settings") {
+    if (!rest.length)
+      fail("Usage: tfa-cli project settings <field=value>…");
+    const settings = parseAssignments2(rest);
+    await api.updateProjectSettings(projectId, settings);
+    process.stderr.write(`${GREEN}✅ project settings updated: ${Object.keys(settings).join(", ")}${RESET}
+`);
+    return;
+  }
+  if (sub === "groups") {
+    const [verb, ...gargs] = rest;
+    if (!verb) {
+      const groups = await api.listProjectGroups(projectId);
+      if (args.json) {
+        console.log(JSON.stringify(groups, null, 2));
+        return;
+      }
+      for (const g of groups)
+        process.stderr.write(`${getItemId2(g) || g.slug}  ${g.name ?? ""}  ${DIM}${g.description ?? ""}${RESET}
+`);
+      return;
+    }
+    if (verb === "set") {
+      const [slug, ...fields] = gargs;
+      if (!slug)
+        fail("Usage: tfa-cli project groups set <slug> <field=value>…");
+      const group = await api.upsertProjectGroup(projectId, slug, parseAssignments2(fields));
+      if (args.json) {
+        console.log(JSON.stringify(group, null, 2));
+        return;
+      }
+      process.stderr.write(`${GREEN}✅ group ${slug} saved${RESET}
+`);
+      return;
+    }
+    if (verb === "reorder") {
+      if (!gargs.length)
+        fail("Usage: tfa-cli project groups reorder <slug>…");
+      await api.reorderProjectGroups(projectId, gargs);
+      process.stderr.write(`${GREEN}✅ groups reordered${RESET}
+`);
+      return;
+    }
+    fail(`Unknown 'project groups' verb: ${verb}`);
+  }
+  fail(`Unknown 'project' subcommand: ${sub}`);
+}
+function printBrandHelp() {
+  process.stderr.write(`
+tfa-cli brand — business contexts (brands) and the learned writing voice
+
+The brand page text itself is a file: read/write todoforai:business-context.
+These commands manage the contexts and the voice learned for them.
+
+Usage:
+  tfa-cli brand list                               Contexts (* = selected)
+  tfa-cli brand create <name>                      New brand (empty .md page)
+  tfa-cli brand rename <brand> <name>
+  tfa-cli brand select <brand|none>                Active brand for the account
+  tfa-cli brand voice                              Learned profile + sources
+  tfa-cli brand voice answers [<q>=<a>…]           Show / set the brand-voice answers (strings)
+  tfa-cli brand voice collect <channel> [--url U | --pasted-file <F|->]
+                                                   Add a writing sample source
+                                                   channels: X LinkedIn Facebook Instagram
+                                                             Gmail Outlook Slack Teams
+  tfa-cli brand voice remove <channel>
+  tfa-cli brand voice learn [--from-company]       Run the refinement loop, store the profile
+
+<brand> is an id or name (unique partial works). Voice subcommands use the
+selected brand unless --brand <id|name> is given (--pasted-file - reads stdin).
+Delete / reset are UI-only.
+
+Questions the UI asks (keys for 'answers'):
+  "What makes you different from competitors?"
+  "What are you working on right now?"
+  "A frustrated customer says things aren't working. How do you reply?"
+`);
+}
+async function resolveBrand(api, query, selectedId) {
+  const contexts = await api.listBusinessContexts();
+  if (!query) {
+    const sel = contexts.find((c3) => c3.id === selectedId);
+    if (sel)
+      return sel;
+    if (contexts.length === 1)
+      return contexts[0];
+    fail("No brand selected — pass --brand <id|name> or 'tfa-cli brand select'");
+  }
+  const q = query.toLowerCase();
+  const exact = contexts.find((c3) => c3.id === query || c3.name.toLowerCase() === q);
+  if (exact)
+    return exact;
+  const partial = contexts.filter((c3) => c3.id.startsWith(query) || c3.name.toLowerCase().includes(q));
+  if (partial.length === 1)
+    return partial[0];
+  fail(partial.length ? `Ambiguous brand '${query}'` : `No brand matching '${query}'`);
+}
+async function brandCommand(api, positionals, args) {
+  const [, sub, ...rest] = positionals;
+  if (!sub || sub === "list") {
+    const contexts = await api.listBusinessContexts();
+    const selected = (await api.getProfile()).user?.selectedBusinessContextId;
+    if (args.json) {
+      console.log(JSON.stringify(contexts.map((c3) => ({ ...c3, selected: c3.id === selected })), null, 2));
+      return;
+    }
+    for (const c3 of contexts)
+      process.stderr.write(`${c3.id === selected ? "*" : " "} ${c3.name}  ${DIM}${c3.id}${RESET}
+`);
+    return;
+  }
+  if (sub === "create") {
+    if (!rest[0])
+      fail("Usage: tfa-cli brand create <name>");
+    const c3 = await api.createBusinessContext(rest[0]);
+    if (args.json) {
+      console.log(JSON.stringify(c3, null, 2));
+      return;
+    }
+    process.stderr.write(`${GREEN}✅ brand ${c3.name} created ${DIM}${c3.id}${RESET}
+`);
+    return;
+  }
+  if (sub === "rename") {
+    if (!rest[1])
+      fail("Usage: tfa-cli brand rename <brand> <name>");
+    const c3 = await resolveBrand(api, rest[0]);
+    await api.renameBusinessContext(c3.id, rest[1]);
+    process.stderr.write(`${GREEN}✅ renamed to ${rest[1]}${RESET}
+`);
+    return;
+  }
+  if (sub === "select") {
+    if (!rest[0])
+      fail("Usage: tfa-cli brand select <brand|none>");
+    const id = rest[0] === "none" ? null : (await resolveBrand(api, rest[0])).id;
+    await api.selectBusinessContext(id);
+    process.stderr.write(`${GREEN}✅ selected brand: ${id ?? "none"}${RESET}
+`);
+    return;
+  }
+  if (sub === "voice")
+    return voiceCommand(api, rest, args);
+  fail(`Unknown 'brand' subcommand: ${sub}`);
+}
+async function voiceCommand(api, rest, args) {
+  const [verb, ...vargs] = rest;
+  const onboarding = await api.getOnboarding();
+  if (verb === "answers") {
+    if (vargs.length) {
+      const given = Object.fromEntries(vargs.map((a) => {
+        const i = a.indexOf("=");
+        if (i < 1)
+          fail(`Expected question=answer, got '${a}'`);
+        return [a.slice(0, i), a.slice(i + 1)];
+      }));
+      const styleAnswers = { ...onboarding.styleAnswers ?? {}, ...given };
+      await api.patchOnboarding({ styleAnswers });
+      process.stderr.write(`${GREEN}✅ ${vargs.length} answer(s) saved${RESET}
+`);
+      return;
+    }
+    const answers = onboarding.styleAnswers ?? {};
+    if (args.json) {
+      console.log(JSON.stringify(answers, null, 2));
+      return;
+    }
+    for (const [q, a] of Object.entries(answers))
+      process.stderr.write(`${q}
+  ${DIM}${a || "(empty)"}${RESET}
+`);
+    return;
+  }
+  const brand = await resolveBrand(api, args.brand, (await api.getProfile()).user?.selectedBusinessContextId);
+  if (!verb || verb === "show") {
+    const profile = onboarding.voiceProfiles?.[brand.id];
+    const { sources } = await api.listVoiceSources(brand.id);
+    if (args.json) {
+      console.log(JSON.stringify({ brand, profile, sources }, null, 2));
+      return;
+    }
+    process.stderr.write(`${brand.name}  ${DIM}${brand.id}${RESET}
+`);
+    process.stderr.write(profile ? `
+${profile.profile}
+${DIM}match ${profile.match}/100 · source ${profile.source}${RESET}
+` : `${DIM}(no voice learned yet)${RESET}
+`);
+    for (const s of sources)
+      process.stderr.write(`  ${s.channel}  ${DIM}${s.posts ?? "?"} posts · ${s.chars ?? "?"} chars${RESET}
+`);
+    return;
+  }
+  if (verb === "collect") {
+    const channel = vargs[0];
+    if (!channel)
+      fail("Usage: tfa-cli brand voice collect <channel> [--url U | --pasted-file F|-]");
+    let pasted;
+    if (args["pasted-file"]) {
+      const { readFileSync: readFileSync3 } = await import("node:fs");
+      pasted = readFileSync3(args["pasted-file"] === "-" ? 0 : args["pasted-file"], "utf8");
+    }
+    const { sources } = await api.collectVoiceSource(brand.id, channel, { url: args.url, pasted });
+    process.stderr.write(`${GREEN}✅ ${channel} collected (${sources.length} source(s))${RESET}
+`);
+    return;
+  }
+  if (verb === "remove") {
+    if (!vargs[0])
+      fail("Usage: tfa-cli brand voice remove <channel>");
+    await api.removeVoiceSource(brand.id, vargs[0]);
+    process.stderr.write(`${GREEN}✅ ${vargs[0]} removed${RESET}
+`);
+    return;
+  }
+  if (verb === "learn") {
+    process.stderr.write(`${DIM}learning voice for ${brand.name}…${RESET}
+`);
+    const res = await api.refineBrandVoice(brand.id, onboarding.styleAnswers ?? {}, args["from-company"] ? "company" : undefined);
+    if (!res.profile)
+      fail("Nothing to learn from — add answers or collect a source first");
+    const { [brand.id]: _stale, ...styleAiAnswers } = onboarding.styleAiAnswers ?? {};
+    await api.patchOnboarding({
+      voiceProfiles: { ...onboarding.voiceProfiles ?? {}, [brand.id]: { ...res, updatedAt: Date.now() } },
+      styleAiAnswers
+    });
+    if (args.json) {
+      console.log(JSON.stringify(res, null, 2));
+      return;
+    }
+    process.stderr.write(`${GREEN}✅ voice learned (match ${res.match}/100, source ${res.source})${RESET}
+${res.profile}
+`);
+    return;
+  }
+  fail(`Unknown 'brand voice' verb: ${verb}`);
+}
+function printDeviceHelp() {
+  process.stderr.write(`
+tfa-cli device — the user's paired machines
+
+Usage:
+  tfa-cli device list
+  tfa-cli device rename <device> <name>        name: [a-zA-Z0-9][a-zA-Z0-9_]*, ≤64
+  tfa-cli device wallpaper <device> auto|off   desktop-wallpaper capture (off deletes stored images)
+
+<device> is an id, name or hostname (unique partial works).
+exec / reboot / update / unpair / workspace paths are UI-only from an agent shell.
+`);
+}
+async function deviceCommand(api, positionals, args) {
+  const [, sub, query, value] = positionals;
+  const devices = await api.listDevices();
+  if (!sub || sub === "list") {
+    if (args.json) {
+      console.log(JSON.stringify(devices, null, 2));
+      return;
+    }
+    for (const d of devices)
+      process.stderr.write(`${d.status === "ONLINE" ? GREEN + "●" : DIM + "○"}${RESET} ${d.name}  ${DIM}${d.deviceType} ${d.metadata?.identity?.hostname ?? ""} ${d.id}${RESET}
+`);
+    return;
+  }
+  if (!query)
+    fail(`Usage: tfa-cli device ${sub} <device> …`);
+  const q = query.toLowerCase();
+  const hit = devices.filter((d) => d.id === query || d.name.toLowerCase() === q || d.metadata?.identity?.hostname?.toLowerCase() === q);
+  const found = hit.length === 1 ? hit[0] : (() => {
+    const p = devices.filter((d) => d.id.startsWith(query) || d.name.toLowerCase().includes(q) || d.metadata?.identity?.hostname?.toLowerCase().includes(q));
+    if (p.length === 1)
+      return p[0];
+    fail(p.length ? `Ambiguous device '${query}'` : `No device matching '${query}'`);
+  })();
+  if (sub === "rename") {
+    if (!value)
+      fail("Usage: tfa-cli device rename <device> <name>");
+    await api.renameDevice(found.id, value);
+    process.stderr.write(`${GREEN}✅ ${found.name} → ${value}${RESET}
+`);
+    return;
+  }
+  if (sub === "wallpaper") {
+    if (value !== "auto" && value !== "off")
+      fail("Usage: tfa-cli device wallpaper <device> auto|off");
+    await api.setDeviceWallpaperMode(found.id, value);
+    process.stderr.write(`${GREEN}✅ ${found.name} wallpaper: ${value}${RESET}
+`);
+    return;
+  }
+  fail(`Unknown 'device' subcommand: ${sub}`);
+}
+
 // src/list-todos.ts
 import { parseArgs as parseArgs2 } from "util";
 var STATUS_COLOR = {
@@ -71932,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 {
@@ -72033,15 +72694,35 @@ 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);
   }
+  if (positionals[0] === "todo" && args.help) {
+    printTodoHelp();
+    process.exit(0);
+  }
+  if (positionals[0] === "project" && args.help) {
+    printProjectHelp();
+    process.exit(0);
+  }
+  if (positionals[0] === "brand" && args.help) {
+    printBrandHelp();
+    process.exit(0);
+  }
+  if (positionals[0] === "device" && args.help) {
+    printDeviceHelp();
+    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])) {
+  if (args.help && !["list", "ls", "agent", "todo", "project", "brand", "device"].includes(positionals[0])) {
     printUsage();
     process.exit(0);
   }
@@ -72153,6 +72834,22 @@ Cancelled by user (Ctrl+C)
 `);
     return;
   }
+  if (positionals[0] === "todo") {
+    await todoCommand(api2, positionals, args);
+    return;
+  }
+  if (positionals[0] === "project") {
+    await projectCommand(api2, positionals, args);
+    return;
+  }
+  if (positionals[0] === "brand") {
+    await brandCommand(api2, positionals, args);
+    return;
+  }
+  if (positionals[0] === "device") {
+    await deviceCommand(api2, positionals, args);
+    return;
+  }
   if (positionals[0] === "delete") {
     const todoId = positionals[1];
     if (!todoId) {
@@ -72491,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 } : {},
@@ -72566,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);
@@ -72584,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;
@@ -72648,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.47",
+  "version": "0.1.49",
   "type": "module",
   "bin": {
     "todoforai-cli": "bin/todoforai-cli.js",