@higherdev/cli 0.1.2 → 0.1.3

package/README.md

@@ -56,15 +56,17 @@ hd ask "why is HD-12 stuck?"
 hd msg HD-12 --to builder "also rename the old column" --interrupt
 ```
 
-`hd plan` runs the **architect** here on your machine, on your ChatGPT
-subscription. It reads the repo, decides what should be built, files an epic,
+`hd plan` talks to **your own model**, here on your machine, on your ChatGPT
+subscription. It is not a worker in a workspace and not a row in the agent
+registry: nothing on the runner dispatches to it, and it reaches the whole
+platform. `hd brain` shows which model it is and connects the subscription the
+first time. It reads the repo, decides what should be built, files an epic,
 and can tune the platform itself: models, effort, routing notes, prompt addenda,
 conventions, budgets. Creating an epic fires `epic.created`, which the
 orchestrator already triggers on, so the handoff needs no glue.
 
 ```bash
-hd connect     # ChatGPT OAuth, once per machine
-hd doctor      # what a run would cost, before it runs
+hd brain       # which model, and connect it the first time
 hd plan        # a conversation: type, it answers, keep going
 ```
 

package/dist/index.js

@@ -11,9 +11,10 @@ var __export = (target, all) => {
 
 // ../../packages/db/src/enums.ts
 function asEffort(value) {
-  return value === "low" || value === "high" ? value : "medium";
+  const raw = typeof value === "string" ? value.trim() : "";
+  return efforts.includes(raw) ? raw : DEFAULT_EFFORT;
 }
-var ticketStatuses, epicStatuses, runStatuses, runKinds, runEventTypes, agentRoles, providers, efforts, messageRoles, messageToRoles, deliveries, createdBy;
+var ticketStatuses, epicStatuses, runStatuses, runKinds, runEventTypes, agentRoles, providers, efforts, messageRoles, messageToRoles, deliveries, createdBy, DEFAULT_EFFORT;
 var init_enums = __esm({
   "../../packages/db/src/enums.ts"() {
     "use strict";
@@ -43,13 +44,14 @@ var init_enums = __esm({
       "error",
       "status"
     ];
-    agentRoles = ["orchestrator", "reviewer", "builder", "architect"];
+    agentRoles = ["orchestrator", "reviewer", "builder"];
     providers = ["claude", "codex", "gemini", "grok"];
     efforts = ["low", "medium", "high"];
     messageRoles = ["human", "operator", "orchestrator", "reviewer", "builder", "architect"];
     messageToRoles = [...messageRoles, "all"];
     deliveries = ["queue", "interrupt"];
     createdBy = ["human", "orchestrator", "api"];
+    DEFAULT_EFFORT = "high";
   }
 });
 
@@ -183,6 +185,8 @@ function auditSummary(actor, action, payload = {}) {
       return key2 ? `${actor} took over ${key2}` : `${actor} took over a ticket`;
     case "hand_back":
       return key2 ? `${actor} handed back ${key2}` : `${actor} handed back a ticket`;
+    case "merge_override":
+      return key2 ? `${actor} authorized an optional-check merge for ${key2}` : `${actor} authorized an optional-check merge`;
     case "create":
       return key2 ? `${actor} created ${key2}` : `${actor} created ${subject(payload)}`;
     case "update":
@@ -456,6 +460,36 @@ var init_cost = __esm({
   }
 });
 
+// ../../packages/db/src/commands/lifecycle.ts
+var lifecycleCommandRejectionCodes, lifecycleCommandResultCodes, TERMINAL_TICKET_STATUSES, OPTIONAL_CHECK_OVERRIDE_STATUSES, ticketStatusSet, terminalStatusSet, optionalCheckOverrideStatusSet;
+var init_lifecycle = __esm({
+  "../../packages/db/src/commands/lifecycle.ts"() {
+    "use strict";
+    init_enums();
+    lifecycleCommandRejectionCodes = [
+      "illegal_transition",
+      "terminal_target",
+      "stale_state",
+      "malformed_intent",
+      "duplicate_command_identity"
+    ];
+    lifecycleCommandResultCodes = ["accepted", ...lifecycleCommandRejectionCodes];
+    TERMINAL_TICKET_STATUSES = ["merged", "cancelled"];
+    OPTIONAL_CHECK_OVERRIDE_STATUSES = ["approved", "needs_decision"];
+    ticketStatusSet = new Set(ticketStatuses);
+    terminalStatusSet = new Set(TERMINAL_TICKET_STATUSES);
+    optionalCheckOverrideStatusSet = new Set(OPTIONAL_CHECK_OVERRIDE_STATUSES);
+  }
+});
+
+// ../../packages/db/src/commands/index.ts
+var init_commands = __esm({
+  "../../packages/db/src/commands/index.ts"() {
+    "use strict";
+    init_lifecycle();
+  }
+});
+
 // ../../packages/db/src/defaults.ts
 function slugify(name) {
   const slug = name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
@@ -467,9 +501,19 @@ function hostAllowsRepo(allowedRepoOwners, repo) {
   if (!owner) return false;
   return allowedRepoOwners.some((item) => item.toLowerCase() === owner);
 }
+var DEFAULT_AGENTS;
 var init_defaults = __esm({
   "../../packages/db/src/defaults.ts"() {
     "use strict";
+    init_enums();
+    DEFAULT_AGENTS = [
+      { role: "orchestrator", provider: "claude", model: "claude-fable-5", display_name: "Orchestrator", effort: DEFAULT_EFFORT },
+      { role: "reviewer", provider: "claude", model: "claude-opus-5", display_name: "Reviewer", effort: DEFAULT_EFFORT },
+      { role: "builder", provider: "claude", model: "claude-sonnet-5", display_name: "Claude", effort: DEFAULT_EFFORT },
+      { role: "builder", provider: "codex", model: "gpt-5.6-sol", display_name: "Codex", effort: DEFAULT_EFFORT },
+      { role: "builder", provider: "gemini", model: "gemini-3.7-flash-high", display_name: "Gemini", effort: DEFAULT_EFFORT },
+      { role: "builder", provider: "grok", model: "grok-4.6", display_name: "Grok", effort: DEFAULT_EFFORT }
+    ];
   }
 });
 
@@ -691,7 +735,7 @@ var init_schemas = __esm({
       role: z.enum(agentRoles),
       provider: z.enum(providers),
       model: z.string().min(1),
-      effort: z.enum(efforts).default("medium"),
+      effort: z.enum(efforts).default(DEFAULT_EFFORT),
       display_name: z.string().min(1),
       enabled: z.boolean(),
       routing_notes: z.string().default(""),
@@ -746,6 +790,7 @@ var init_schemas = __esm({
       next_review_at: isoDateSchema.nullable(),
       created_by: z.enum(createdBy),
       last_error: z.string().nullable(),
+      merge_override_optional_checks: z.boolean().default(false),
       created_at: isoDateSchema,
       updated_at: isoDateSchema
     });
@@ -835,7 +880,8 @@ var init_schemas = __esm({
       "dismiss",
       "reroute",
       "takeover",
-      "hand_back"
+      "hand_back",
+      "merge_override"
     ]);
     auditEventSchema = z.object({
       id: uuidSchema,
@@ -1036,6 +1082,32 @@ var init_templates = __esm({
   }
 });
 
+// ../../packages/db/src/tickets.ts
+function uncertainCreateError(error) {
+  return Boolean(error && (!error.code || /^PGRST00[0-3]$/.test(error.code)));
+}
+async function createTicketRecord(db, workspaceId, fields, ticketId) {
+  const requestId = ticketId ?? globalThis.crypto.randomUUID();
+  const args = {
+    p_ticket_id: requestId,
+    p_workspace_id: workspaceId,
+    p_fields: fields
+  };
+  for (let attempt = 0; ; attempt += 1) {
+    try {
+      const result = await db.rpc("create_ticket", args);
+      if (!result.error || attempt === 1 || !uncertainCreateError(result.error)) return result;
+    } catch (error) {
+      if (attempt === 1) throw error;
+    }
+  }
+}
+var init_tickets = __esm({
+  "../../packages/db/src/tickets.ts"() {
+    "use strict";
+  }
+});
+
 // ../../packages/db/src/ticket-writes.ts
 async function workspaceBySlug(db, slug) {
   const { data, error } = await db.from("workspaces").select("*").eq("slug", slug).maybeSingle();
@@ -1134,7 +1206,13 @@ function buildTimeline(input) {
       id: `run:${run5.id}`,
       at,
       kind,
-      title: [run5.kind, run5.provider, run5.status, span].filter(Boolean).join(" "),
+      title: [
+        run5.kind,
+        run5.provider,
+        run5.status,
+        run5.reviewed_sha ? `@ ${run5.reviewed_sha.slice(0, 12)}` : "",
+        span
+      ].filter(Boolean).join(" "),
       detail: run5.summary ? clip(run5.summary) : void 0,
       durationMs: runDurationMs(run5, nowIso),
       endedAt: run5.ended_at
@@ -1388,6 +1466,7 @@ var init_src = __esm({
     init_blocked();
     init_budgets();
     init_cost();
+    init_commands();
     init_defaults();
     init_enums();
     init_epic_progress();
@@ -1399,6 +1478,7 @@ var init_src = __esm({
     init_status();
     init_stuck();
     init_templates();
+    init_tickets();
     init_ticket_writes();
     init_timeline();
     init_transcript();
@@ -4037,10 +4117,8 @@ async function createTicket(ctx, input) {
     assigned: Boolean(assigned.agent),
     blockerStatuses: blockers.statuses
   });
-  const { data, error } = await ctx.db.from("tickets").insert({
-    workspace_id: ctx.workspace.id,
+  const { data, error } = await createTicketRecord(ctx.db, ctx.workspace.id, {
     epic_id: input.epic ?? null,
-    key: "",
     title,
     body_md: input.body ?? "",
     acceptance_md: acceptance,
@@ -4053,7 +4131,7 @@ async function createTicket(ctx, input) {
     provider_pinned: Boolean(assigned.agent),
     blocked_by: blockers.ids,
     created_by: "human"
-  }).select("*").single();
+  });
   if (error) fail(error.message);
   await ctx.audit(ctx.workspace.id, "create", { ticket_key: data.key, subject: "a ticket" });
   return data;
@@ -4141,7 +4219,12 @@ async function handBack(ctx, ticket) {
   return data;
 }
 async function killRun(ctx, runId, ticketKey) {
-  const { data, error } = await ctx.db.from("runs").update({ status: "killed", ended_at: (/* @__PURE__ */ new Date()).toISOString(), summary: `Killed by ${ctx.email}.` }).eq("id", runId).eq("workspace_id", ctx.workspace.id).select("*").maybeSingle();
+  const { data, error } = await ctx.db.rpc("request_run_cancellation", {
+    p_run_id: runId,
+    p_workspace_id: ctx.workspace.id,
+    p_requested_by: ctx.email,
+    p_reason: `Cancellation requested by ${ctx.email}.`
+  });
   if (error) fail(error.message);
   if (!data) fail(`No run ${runId} in ${ctx.workspace.slug}.`);
   await ctx.audit(ctx.workspace.id, "kill", { ticket_key: ticketKey, run_id: runId });
@@ -4273,14 +4356,14 @@ function registerWriteCommands(program) {
       const live = runs2.find((run6) => run6.status === "running" || run6.status === "queued");
       if (!live) fail(`${ticket.key} has no live run.`);
       const killed2 = await killRun(ctx, live.id, ticket.key);
-      ok(`Killed ${c.dim(killed2.id.slice(0, 8))} on ${c.bold(ticket.key)}.`, { run: killed2 });
+      ok(`Cancellation requested for ${c.dim(killed2.id.slice(0, 8))} on ${c.bold(ticket.key)}.`, { run: killed2 });
       return;
     }
     const runs = await loadRuns(ctx, { limit: 200 });
     const run5 = runs.find((row) => row.id.startsWith(target));
     if (!run5) fail(`No run matching ${target}.`);
     const killed = await killRun(ctx, run5.id);
-    ok(`Killed ${c.dim(killed.id.slice(0, 8))}.`, { run: killed });
+    ok(`Cancellation requested for ${c.dim(killed.id.slice(0, 8))}.`, { run: killed });
   });
   const epic = group(program, "epic", "epics and their dependency waves");
   epic.command("new").argument("<title>", "epic title").argument("[spec]", "path to a markdown spec").description("create an epic; the orchestrator decomposes it").action(async function(title, spec) {
@@ -4591,7 +4674,7 @@ function registerAgentCommands(program) {
           row.role,
           row.provider,
           c.dim(row.model),
-          row.effort,
+          asEffort(row.effort),
           row.enabled ? c.green("yes") : c.dim("no"),
           truncate(row.routing_notes ?? "", 44)
         ])
@@ -4605,7 +4688,7 @@ function registerAgentCommands(program) {
       found,
       () => [
         `${c.bold(found.display_name)} ${c.dim(found.role)}`,
-        `${c.dim("model")}    ${found.provider}/${found.model} ${c.dim(`effort ${found.effort}`)}`,
+        `${c.dim("model")}    ${found.provider}/${found.model} ${c.dim(`effort ${asEffort(found.effort)}`)}`,
         `${c.dim("enabled")}  ${found.enabled ? "yes" : "no"}`,
         `${c.dim("caps")}     ${found.runs_per_hour ?? "unlimited"} runs/hour, ${found.daily_spend_usd ?? "unlimited"} usd/day`,
         found.routing_notes ? `
@@ -4660,7 +4743,7 @@ ${found.prompt_addendum}` : ""
     await ctx.audit(ctx.workspace.id, "configure", { subject: `agent ${data.display_name}` });
     ok(`${c.bold(data.display_name)} updated.`, { agent: data });
   });
-  agent.command("new").argument("<name>", "display name").description("add a builder").requiredOption("--provider <provider>", "claude, codex, gemini, or grok").requiredOption("--model <model>", "model id").option("--effort <level>", "low, medium, or high", "medium").option("--notes <text>", "routing notes").action(async function(name) {
+  agent.command("new").argument("<name>", "display name").description("add a builder").requiredOption("--provider <provider>", "claude, codex, gemini, or grok").requiredOption("--model <model>", "model id").option("--effort <level>", "low, medium, or high", DEFAULT_EFFORT).option("--notes <text>", "routing notes").action(async function(name) {
     const opts = this.opts();
     const ctx = await requireWorkspace(slugOf5(this));
     if (!providers.includes(opts.provider)) {
@@ -4745,8 +4828,13 @@ function registerWorkspaceCommands(program) {
       default_host: opts.host
     }).select("*").single();
     if (error) fail(error.message);
+    const { error: agentsError } = await ctx.db.from("agents").insert(DEFAULT_AGENTS.map((agent) => ({ ...agent, workspace_id: data.id })));
+    if (agentsError) fail(`Workspace created, but seeding its agents failed: ${agentsError.message}`);
     await ctx.audit(data.id, "create", { subject: `workspace ${data.slug}` });
-    ok(`${c.bold(data.slug)} created. Run \`hd use ${data.slug}\`.`, { workspace: data });
+    ok(
+      `${c.bold(data.slug)} created with ${DEFAULT_AGENTS.length} agents. Run \`hd use ${data.slug}\`.`,
+      { workspace: data }
+    );
   });
   workspace.command("set").description("change workspace settings").option("--branch <name>", "default branch").option("--host <id>", "default host").option("--auto-merge", "merge approved PRs automatically").option("--no-auto-merge", "wait for a human to merge").option("--cap <provider=n...>", "set a provider cap, e.g. --cap claude=2").action(async function() {
     const opts = this.opts();
@@ -4878,7 +4966,7 @@ function registerAttachCommands(program) {
 }
 
 // src/architect/commands.ts
-import { createInterface as createInterface2 } from "readline/promises";
+import { createInterface as createInterface3 } from "readline/promises";
 init_json();
 init_theme();
 
@@ -4888,7 +4976,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { z as z3 } from "zod";
 
 // src/version.ts
-var VERSION = "0.1.2";
+var VERSION = "0.1.3";
 
 // src/architect/tools.ts
 init_src();
@@ -5401,13 +5489,93 @@ async function serveMcp(opts) {
 init_json();
 init_theme();
 init_chatgpt();
-init_connection();
 import { execFile as execFile2 } from "child_process";
 import { mkdir as mkdir2 } from "fs/promises";
 import { homedir as homedir3 } from "os";
 import path6 from "path";
 import { promisify as promisify2 } from "util";
 
+// src/architect/brain.ts
+import { createInterface as createInterface2 } from "readline/promises";
+init_json();
+init_theme();
+init_connection();
+var BRAINS = [
+  {
+    id: "chatgpt",
+    label: "ChatGPT subscription",
+    billing: "included in your ChatGPT plan, nothing per token",
+    // gpt-5.6, without a suffix, is refused by this endpoint for ChatGPT accounts.
+    defaultModel: "gpt-5.6-sol",
+    models: ["gpt-5.6-sol", "gpt-5.5"]
+  }
+];
+var DEFAULT_BRAIN = {
+  id: "chatgpt",
+  model: "gpt-5.6-sol",
+  effort: "high"
+};
+function brainById(id) {
+  return BRAINS.find((brain) => brain.id === id) ?? null;
+}
+function describeBrain(config) {
+  const brain = brainById(config.id);
+  return `${brain?.label ?? config.id} (${config.model}, effort ${config.effort})`;
+}
+async function confirm(question) {
+  const rl = createInterface2({ input: process.stdin, output: process.stderr });
+  try {
+    const answer = (await rl.question(question)).trim().toLowerCase();
+    return answer === "" || answer === "y" || answer === "yes";
+  } finally {
+    rl.close();
+  }
+}
+async function requireBrain(opts = {}) {
+  const config = await loadConfig();
+  const chosen = config.brain ?? DEFAULT_BRAIN;
+  const interactive = opts.interactive ?? (process.stdin.isTTY && process.stdout.isTTY);
+  const connection = await codexConnection();
+  if (connection.state === "connected") {
+    if (!config.brain) await saveConfig({ brain: chosen });
+    return chosen;
+  }
+  if (!interactive) {
+    fail(`${connectionSummary(connection)}
+${howToFix(connection) ?? ""}`.trim());
+  }
+  if (connection.state === "not_installed") {
+    fail(`${connectionSummary(connection)}
+${howToFix(connection) ?? ""}`.trim());
+  }
+  const brain = brainById(chosen.id);
+  out("");
+  out(`${c.bold("HigherDEV needs your ChatGPT subscription to answer.")}`);
+  out(c.dim(`${brain?.billing ?? ""}. The sign-in happens in your browser; hd never sees the token.`));
+  if (!await confirm(c.dim("Press enter to sign in, or n to cancel: "))) {
+    fail("Not connected. Run `hd brain` when you want to.");
+  }
+  const connected = await connectCodex();
+  if (connected.state !== "connected") {
+    fail(`${connectionSummary(connected)}
+${howToFix(connected) ?? ""}`.trim());
+  }
+  out(c.green(connectionSummary(connected)));
+  await saveConfig({ brain: chosen });
+  return chosen;
+}
+async function setBrain(patch) {
+  const config = await loadConfig();
+  const next = { ...config.brain ?? DEFAULT_BRAIN, ...patch };
+  const brain = brainById(next.id);
+  if (!brain) fail(`Unknown brain ${next.id}. One of: ${BRAINS.map((row) => row.id).join(", ")}.`);
+  if (patch.model && !brain.models.includes(patch.model)) {
+    out(c.yellow(`${patch.model} is not one of the models known to work here (${brain.models.join(", ")}).`));
+  }
+  await saveConfig({ brain: next });
+  return next;
+}
+
 // src/architect/repo.ts
 import { readFile as readFile6, readdir, stat } from "fs/promises";
 import path5 from "path";
@@ -5564,18 +5732,6 @@ function buildRepoTools(root) {
 
 // src/architect/plan.ts
 var run2 = promisify2(execFile2);
-var ARCHITECT_ROLE = "architect";
-async function architectAgent(ctx) {
-  const { data, error } = await ctx.db.from("agents").select("*").eq("workspace_id", ctx.workspace.id).eq("role", ARCHITECT_ROLE).maybeSingle();
-  if (error) fail(error.message);
-  if (!data) {
-    fail(
-      "This workspace has no architect agent. Apply the migrations, or add one with:\n  hd agent new Architect --provider codex --model gpt-5.6-sol"
-    );
-  }
-  if (!data.enabled) fail(`${data.display_name} is disabled. Enable it with \`hd agent set ${data.display_name} --enable\`.`);
-  return data;
-}
 async function repoCheckout(ctx) {
   const here = process.cwd();
   try {
@@ -5632,19 +5788,12 @@ function architectInstructions(opts) {
     "conventions, budgets, pausing. The orchestrator has no action for any of it.",
     "",
     opts.readOnly ? "This session is read-only. Propose in your reply; the tools that change things are not loaded." : "Say what you filed and what the owner should look at.",
-    "Answer conversationally and briefly. Lead with the answer. Never use an em dash.",
-    opts.addendum ? `
-${opts.addendum}` : ""
+    "Answer conversationally and briefly. Lead with the answer. Never use an em dash."
   ].filter(Boolean).join("\n");
 }
 async function openArchitect(opts) {
   const { ctx } = opts;
-  const agent = await architectAgent(ctx);
-  const connection = await codexConnection();
-  if (connection.state !== "connected" && !opts.allowApiBilling) {
-    fail(`${connectionSummary(connection)}
-${howToFix(connection) ?? ""}`.trim());
-  }
+  const brain = await requireBrain();
   const repo = await repoCheckout(ctx);
   const platformTools = toolsFor(opts.readOnly ? "read" : "all").map((tool) => ({
     name: tool.name,
@@ -5653,10 +5802,9 @@ ${howToFix(connection) ?? ""}`.trim());
     run: (args) => tool.run(ctx, args)
   }));
   return {
-    agent,
+    brain,
     instructions: architectInstructions({
       ctx,
-      addendum: agent.prompt_addendum,
       readOnly: opts.readOnly,
       hasRepo: Boolean(repo)
     }),
@@ -5671,10 +5819,12 @@ async function architectTurn(opts) {
   const { data: runRow, error: runError } = await ctx.db.from("runs").insert({
     workspace_id: ctx.workspace.id,
     ticket_id: null,
-    agent_id: session.agent.id,
+    // No agent: the brain is the operator's own model, not a worker in this
+    // workspace. The run exists so what it spends is still visible.
+    agent_id: null,
     kind: "architect",
-    provider: session.agent.provider,
-    model: session.agent.model,
+    provider: "codex",
+    model: session.brain.model,
     status: "running",
     started_at: (/* @__PURE__ */ new Date()).toISOString(),
     session_id: session.sessionId,
@@ -5693,7 +5843,7 @@ async function architectTurn(opts) {
       instructions: session.instructions,
       history: session.history,
       tools: session.tools,
-      model: session.agent.model,
+      model: session.brain.model,
       sessionId: session.sessionId,
       signal: opts.signal,
       onEvent: (event) => {
@@ -5715,7 +5865,7 @@ async function architectTurn(opts) {
       turns: result.steps,
       summary: result.text.slice(0, 500) || "Architect turn"
     }).eq("id", runRow.id);
-    await ctx.audit(ctx.workspace.id, "architect", { subject: session.agent.display_name });
+    await ctx.audit(ctx.workspace.id, "architect", { subject: describeBrain(session.brain) });
     return { text: result.text, runId: runRow.id, toolCalls: result.toolCalls };
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -5738,7 +5888,7 @@ function slugOf6(command) {
   return command.optsWithGlobals().workspace;
 }
 async function askLine(prompt2) {
-  const rl = createInterface2({ input: process.stdin, output: process.stderr });
+  const rl = createInterface3({ input: process.stdin, output: process.stderr });
   try {
     return await new Promise((resolve) => {
       rl.once("close", () => resolve(""));
@@ -5759,16 +5909,12 @@ ${howToFix(connection) ?? ""}`.trim()
   );
 }
 function registerArchitectCommands(program) {
-  program.command("plan").argument("[request...]", "what to plan, assess, or change; omit for a conversation").description("the architect: assess the repo, shape the work, tune the platform").option("--read-only", "let it look and propose, but change nothing").option("--once", "run a single turn and exit, even without a request").option("--allow-api-billing", "run even when Codex would bill per token instead of the subscription").action(async function(request) {
+  program.command("plan").argument("[request...]", "what to plan, assess, or change; omit for a conversation").description("the architect: assess the repo, shape the work, tune the platform").option("--read-only", "let it look and propose, but change nothing").option("--once", "run a single turn and exit, even without a request").action(async function(request) {
     const opts = this.opts();
     const ctx = await requireWorkspace(slugOf6(this));
     const first = request.join(" ").trim();
     const conversational = !first && !opts.once && process.stdin.isTTY && !isJsonMode();
-    const session = await openArchitect({
-      ctx,
-      readOnly: Boolean(opts.readOnly),
-      allowApiBilling: Boolean(opts.allowApiBilling)
-    });
+    const session = await openArchitect({ ctx, readOnly: Boolean(opts.readOnly) });
     let wroteText = false;
     const onEvent = (event) => {
       if (isJsonMode()) return;
@@ -5811,7 +5957,7 @@ function registerArchitectCommands(program) {
     }
     out(
       c.dim(
-        `Talking to the architect (${session.agent.model}${session.repo ? ", repo readable" : ""}). Blank line or /exit leaves.`
+        `${describeBrain(session.brain)}${session.repo ? ", repo readable" : ""}. Blank line or /exit leaves.`
       )
     );
     for (; ; ) {
@@ -5836,6 +5982,33 @@ function registerArchitectCommands(program) {
     }
     await serveMcp({ readOnly, workspace: slugOf6(this) });
   });
+  program.command("brain").description("the model you talk to, and the subscription behind it").option("--model <model>", "which model to use").option("--effort <level>", "low, medium, or high").action(async function() {
+    const opts = this.opts();
+    if (opts.model || opts.effort) {
+      const next = await setBrain({
+        ...opts.model ? { model: String(opts.model) } : {},
+        ...opts.effort ? { effort: String(opts.effort) } : {}
+      });
+      ok(describeBrain(next), { brain: next });
+      return;
+    }
+    const config = await loadConfig();
+    const chosen = config.brain ?? DEFAULT_BRAIN;
+    const connection = await codexConnection();
+    emit(
+      { brain: chosen, connected: connection.state === "connected", codex: connection },
+      () => [
+        `${c.bold(describeBrain(chosen))}`,
+        ...BRAINS.map(
+          (brain) => `  ${brain.id === chosen.id ? c.blue("*") : " "} ${brain.label.padEnd(24)} ${c.dim(brain.billing)}`
+        ),
+        "",
+        connection.state === "connected" ? c.green(connectionSummary(connection)) : `${c.yellow(connectionSummary(connection))}
+${howToFix(connection) ?? ""}`,
+        c.dim("Models: " + (brainById(chosen.id)?.models.join(", ") ?? ""))
+      ].join("\n")
+    );
+  });
   program.command("connect").description("connect Codex to your ChatGPT subscription, so the architect costs nothing per token").option("--check", "report the state without starting a login").action(async function() {
     let connection = await codexConnection();
     if (connection.state === "connected" || this.opts().check) {
@@ -5952,7 +6125,7 @@ ${runner.HD_HELP}`);
 
 // src/host/upgrade.ts
 import { execFile as execFile5 } from "child_process";
-import { createInterface as createInterface3 } from "readline/promises";
+import { createInterface as createInterface4 } from "readline/promises";
 import { promisify as promisify5 } from "util";
 init_json();
 init_theme();
@@ -6001,7 +6174,7 @@ async function offerUpdate(now = Date.now()) {
   await saveUpdateState({ checked_at: now });
   if (!latest || !isNewer(latest, VERSION)) return;
   if (state.skipped === latest) return;
-  const rl = createInterface3({ input: process.stdin, output: process.stderr });
+  const rl = createInterface4({ input: process.stdin, output: process.stderr });
   let answer = "";
   try {
     answer = (await rl.question(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@higherdev/cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "description": "HigherDEV in your terminal. Full control of the board, live.",
   "bin": {