@todoforai/cli 0.1.47 → 0.1.48

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.48",
   type: "module",
   bin: {
     "todoforai-cli": "bin/todoforai-cli.js",
@@ -44507,7 +44583,11 @@ Usage:
   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 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 delete <todo-id>              # Permanently delete a todo
@@ -44614,6 +44694,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" },
@@ -47290,6 +47374,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 +47393,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 +47405,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 +47413,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 +47421,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 +47471,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 +47482,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 +47556,493 @@ 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 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 (!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 = {
@@ -72037,11 +72657,27 @@ Cancelled by user (Ctrl+C)
     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 +72789,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) {

package/package.json

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