windows-development-sandbox 1.18.4 → 1.23.0

package/dist/bin/{chunk-N4GXYTLV.js → chunk-JETGP2C3.js}

@@ -33,6 +33,7 @@ import {
   REQUEST_APP,
   RunDir,
   SAVED,
+  SYSTEM,
   SandboxChannel,
   SchemaNode,
   ServerMessageSchema,
@@ -44,10 +45,16 @@ import {
   __commonJS,
   __require,
   __toESM,
+  accessView,
+  accountsView,
   action,
-  agentCommandsCommand,
+  agentCommandsStatus,
+  agentEnv,
+  agentEnvPage,
+  agentEnvView,
   agentPage,
   agentsPage,
+  agentsView,
   allowStorePath,
   allowedAnswer,
   allows,
@@ -55,11 +62,13 @@ import {
   appIsOn,
   appRows,
   applyOverrides,
+  appsView,
   askChoice,
   assertSafeWorkspace,
   attach,
   auditArgv,
   auditPage,
+  auditView,
   autoMigrates,
   c,
   canAnimate,
@@ -76,6 +85,7 @@ import {
   currentUserName,
   customRows,
   dataPage,
+  dataView,
   defaultsContext,
   definitionHandler,
   describeCopy,
@@ -89,6 +99,7 @@ import {
   engineLeftovers,
   enginePage,
   engineStatus,
+  engineView,
   ensureStorageRoot,
   entriesOf,
   errMsg,
@@ -106,8 +117,10 @@ import {
   githubLogout,
   githubStatus,
   githubTokenRowOf,
+  githubView,
   guestWorkspaceOf,
   healthPage,
+  healthView,
   healthWith,
   hereDir,
   hostAgent,
@@ -125,6 +138,7 @@ import {
   lastHealth,
   launch,
   ledgerToReopen,
+  link,
   listAccounts,
   listAgents,
   listAudit,
@@ -134,6 +148,7 @@ import {
   listSettings,
   loadConfig,
   logsPage,
+  logsView,
   lookAtSandbox,
   loosenedRequests,
   measureFolder,
@@ -157,6 +172,7 @@ import {
   previewGuest,
   printJson,
   projectsPage,
+  projectsView,
   protectPrivateFolder,
   provisionJoined,
   readLocalConfig,
@@ -179,13 +195,16 @@ import {
   sandboxPage,
   sandboxPids,
   sandboxStatus,
+  sandboxView,
   serviceCategory,
   servicePage,
   sessionsPage,
   sessionsToReopen,
+  sessionsView,
   settingRow,
   settingsOf,
   settingsPage,
+  settingsView,
   setup,
   shouldReopen,
   showData,
@@ -194,6 +213,7 @@ import {
   spawnDetached,
   staleMountNote,
   storagePage,
+  storageView,
   summary,
   summaryText,
   syncBack,
@@ -205,6 +225,7 @@ import {
   trustStorePath,
   updatesPage,
   updatesStatus,
+  updatesView,
   useSharedSandbox,
   useTasklistCache,
   userConfigPath,
@@ -219,16 +240,18 @@ import {
   vpnLoginRowOf,
   vpnLogout,
   vpnStatus,
+  vpnView,
   watch,
   web,
   webPage,
   webServer,
   webStatus,
+  webView,
   whereOf,
   withOperationCommands,
   working,
   writeJson
-} from "./chunk-FRPLQLSY.js";
+} from "./chunk-ZTTOF5V3.js";
 
 // node_modules/commander/lib/error.js
 var require_error = __commonJS({
@@ -3948,6 +3971,7 @@ var COMMAND_LIST = [
       "sandbox account status             the service sign-ins (Epic, Steam, Unity, signing keys ...)",
       "sandbox account import epic        take this PC's Epic Games Launcher sign-in for sandboxes",
       "sandbox account login cfx          type a FiveM server key to keep for sandboxes",
+      "sandbox account login perplexity   type a Perplexity API key (or: import perplexity --from .env)",
       "sandbox account logout steam       forget a service sign-in",
       "sandbox account save free --api-key   save an Anthropic API key you paste in (not shown)"
     ],
@@ -3960,7 +3984,7 @@ var COMMAND_LIST = [
       },
       {
         name: "name",
-        description: "account name, or the service (status, import, login, logout): epic, steam, unity, cfx, keystore, play, expo or appstore",
+        description: "account name, or the service (status, import, login, logout): epic, steam, unity, cfx, keystore, play, expo, appstore, perplexity or comet",
         required: false,
         choices: "accounts"
       }
@@ -4153,7 +4177,7 @@ var COMMAND_LIST = [
   },
   {
     name: "agent-commands",
-    summary: "(Beta) make claude, codex ... on this PC start in a hidden sandbox and attach",
+    summary: "make claude, codex ... on this PC start in a hidden sandbox and attach",
     group: "Advanced",
     args: [{ name: "action", description: "on, off or status", required: false, choices: ["status", "on", "off"] }],
     options: []
@@ -4887,7 +4911,9 @@ var TextScreen = class {
     }
     if (key.text) {
       const accept = this.o.accept;
-      const add = [...key.text.replace(/[\r\n]/g, "")].filter((c2) => !accept || accept.test(c2));
+      const add = [...key.text.replace(/\x1b?\[20[01]~/g, "").replace(/[\r\n]/g, "")].filter(
+        (c2) => !accept || accept.test(c2)
+      );
       if (!add.length) return;
       set([...chars.slice(0, this.cursor), ...add, ...chars.slice(this.cursor)], this.cursor + add.length);
     }
@@ -6054,9 +6080,10 @@ var Terminal = class {
     });
   }
   push(str, key) {
+    const marker = key?.name === "paste-start" || key?.name === "paste-end";
     const event = {
       name: key?.name ?? "",
-      text: str && !key?.ctrl && !key?.meta && str.length >= 1 && str >= " " && str !== "\x7F" ? str : "",
+      text: str && !marker && !key?.ctrl && !key?.meta && str.length >= 1 && str >= " " && str !== "\x7F" ? str : "",
       ctrl: Boolean(key?.ctrl),
       meta: Boolean(key?.meta),
       shift: Boolean(key?.shift)
@@ -6091,6 +6118,8 @@ var App = class {
   onKey = () => void 0;
   /** The navigation on the left of every screen (none: no navigation column). */
   nav = () => void 0;
+  /** Opens another section of the menu (the shell sets it): what a link to a setting or a view does. */
+  goTo = () => Promise.resolve();
   /** The screens being shown, innermost last: a dialog is drawn over the one below it. */
   shown = [];
   redrawNow = null;
@@ -6200,6 +6229,9 @@ var App = class {
   }
 };
 
+// src/cli/menu/io-menu.ts
+import { spawn } from "node:child_process";
+
 // src/cli/menu/settings/ask-path.ts
 function askPath(app, o) {
   return app.pickPath({
@@ -6696,6 +6728,31 @@ var ValueEditor = class {
   }
 };
 
+// src/cli/menu/views.ts
+var MENU_VIEWS = [
+  { view: agentsView, section: "Agents" },
+  { view: agentEnvView, section: "Agents" },
+  { view: sessionsView, section: "Sessions" },
+  { view: sandboxView, section: "Sandbox" },
+  { view: settingsView, section: "Settings" },
+  { view: accountsView, section: "Accounts" },
+  { view: appsView, section: "Apps" },
+  { view: projectsView, section: "Sandbox" },
+  { view: healthView, section: "Maintenance" },
+  { view: dataView, section: "Maintenance" },
+  { view: storageView, section: "Maintenance" },
+  { view: logsView, section: "Maintenance" },
+  { view: auditView, section: "Maintenance" },
+  { view: updatesView, section: "Maintenance" },
+  { view: engineView, section: "Maintenance" },
+  { view: webView, section: "Maintenance" },
+  { view: accessView, section: "Maintenance" },
+  // The Settings page draws the VPN row itself (its login is staged with the settings); the view lists its operations.
+  { view: vpnView, section: "Settings" },
+  // The same for the GitHub token row.
+  { view: githubView, section: "Settings" }
+];
+
 // src/cli/menu/io-menu.ts
 async function ask(app, where, q, said) {
   const lines = [...said, ...q.lines ?? [], ..."problem" in q && q.problem ? [Theme.warn(q.problem)] : []];
@@ -6738,7 +6795,22 @@ async function ask(app, where, q, said) {
       });
   }
 }
-function follow(target) {
+function placeOf(view) {
+  const place = MENU_VIEWS.find((m) => m.view.id === view);
+  if (!place) return void 0;
+  return { section: place.section, ...view === "agentEnv" ? { category: "env" } : {} };
+}
+function openUrl(href) {
+  if (!/^https:\/\/github\.com\//.test(href)) return;
+  const child = spawn(SYSTEM.cmd(), ["/c", "start", '""', href.replace(/&/g, "^&")], {
+    stdio: "ignore",
+    detached: true,
+    windowsHide: true
+  });
+  child.on("error", () => void 0);
+  child.unref();
+}
+function follow(target, app) {
   switch (target.kind) {
     case "terminal":
       return { exit: { kind: "run", argv: ["attach", target.session] } };
@@ -6746,8 +6818,17 @@ function follow(target) {
       return { exit: { kind: "run", argv: ["launch", "--harness", target.agent] } };
     case "command":
       return { exit: { kind: "run", argv: [...target.argv] } };
-    case "view":
-      return {};
+    case "view": {
+      const place = placeOf(target.view);
+      if (!place || !app) return {};
+      return app.goTo(place.section, { category: place.category }).then(() => ({}));
+    }
+    case "setting":
+      if (!app) return {};
+      return app.goTo("Settings", { search: target.key }).then(() => ({}));
+    case "url":
+      openUrl(target.href);
+      return { notice: Theme.muted("Opened " + target.href + " in your browser.") };
   }
 }
 var MenuOperations = class {
@@ -6759,7 +6840,7 @@ var MenuOperations = class {
   runner;
   /** Does what an action of a page says: follows a link, or asks for its fields and runs its operation. */
   async perform(action2, where, busy, onOutput) {
-    if (action2.kind === "link") return follow(action2.target);
+    if (action2.kind === "link") return follow(action2.target, this.app);
     const def = operationById(action2.op);
     if (!def) return { notice: Theme.error(Theme.glyph.cross + " Unknown operation " + action2.op + ".") };
     const answers = await this.fields(action2, def, where);
@@ -6785,6 +6866,15 @@ var MenuOperations = class {
     }
     return answers;
   }
+  /** A failure that names a fix: a dialog with the fix as a button; its result replaces the failure notice. */
+  async offerFix(problem, where, busy) {
+    const fix = problem.action;
+    const def = fix ? operationById(fix.op) : void 0;
+    if (!fix || !def) return void 0;
+    const yes = await this.app.ask(problem.message, problem.fix ? [problem.fix] : [], fix.label);
+    if (!yes) return void 0;
+    return await this.run(def, fix.input ?? {}, where, busy) ?? Theme.ok(Theme.glyph.ok + " Done.");
+  }
   /**
    * Runs a definition with this input and returns the notice to show: its text (✓), the problem and its fix (✘), or
    * undefined when a question was declined (nothing changed, nothing to say).
@@ -6805,7 +6895,8 @@ var MenuOperations = class {
       if (e instanceof Cancelled) return void 0;
       const problem = toWireError(e);
       if (problem.kind === "bug") return Theme.error(Theme.glyph.cross + " " + errMsg(e));
-      return Theme.error(Theme.glyph.cross + " " + problem.message) + (problem.fix ? Theme.muted("  " + problem.fix) : "");
+      const notice = Theme.error(Theme.glyph.cross + " " + problem.message) + (problem.fix ? Theme.muted("  " + problem.fix) : "");
+      return await this.offerFix(problem, where, busy) ?? notice;
     }
   }
 };
@@ -7130,7 +7221,7 @@ function accountsOptions(m) {
       ...m.services.map((s) => ({
         id: serviceCategory(s.kind),
         label: s.label,
-        description: "Your " + s.label + " sign-in for sandboxes that use " + s.usedBy.join(" or ") + "."
+        description: "Your " + s.label + " sign-in for sandboxes that use " + s.usedFor + "."
       }))
     ],
     items: [
@@ -7714,6 +7805,9 @@ var SeveralAgents = class {
 };
 
 // src/cli/menu/pages/agents-page.ts
+function commandsOf(m) {
+  return m.agentCommands ?? { enabled: m.hostAgents.length > 0, dir: "", found: [] };
+}
 function agentsList(m) {
   const removable = m.removable ?? [];
   return {
@@ -7728,7 +7822,12 @@ function agentsList(m) {
   };
 }
 function startView(m) {
-  return menuView(agentsPage(agentsList(m)), { category: "start", refresh: false });
+  const page = agentsPage(agentsList(m), commandsOf(m));
+  return menuView({ ...page, sections: page.sections.slice(0, 1) }, { category: "start", refresh: false });
+}
+function commandsView(m) {
+  const page = agentsPage(agentsList(m), commandsOf(m));
+  return menuView({ ...page, sections: page.sections.slice(1) }, { category: "host", refresh: false });
 }
 function hostAgentsToShow(enabled, found) {
   return enabled ? found.map((a) => a.harness) : [];
@@ -7754,14 +7853,19 @@ function agentCategories(m) {
       label: "Start",
       description: "Agents you can start in " + m.folder + ". Add an agent at the end of the list."
     },
-    { id: "options", label: "Options", description: "How a start goes, and the other ways to start." },
-    ...m.hostAgents.length ? [
+    ...m.claudeEnv ? [
       {
-        id: "host",
-        label: "On this PC",
-        description: "The real agents on this PC, with no sandbox around them."
+        id: "env",
+        label: "Claude environment",
+        description: "Models, limits, how many subagents run at once, and other variables of Claude."
       }
-    ] : []
+    ] : [],
+    { id: "options", label: "Options", description: "How a start goes, and the other ways to start." },
+    {
+      id: "host",
+      label: "On this PC",
+      description: "Agent commands: typing claude, codex ... here starts them in a sandbox. The real agents are listed too."
+    }
   ];
 }
 function startRow(item2, m, cwd) {
@@ -7773,8 +7877,18 @@ function startRow(item2, m, cwd) {
     details: [Theme.muted("Command  ") + commandLine(startArgv(m, name, cwd))]
   };
 }
+function envView(m) {
+  return m.claudeEnv ? menuView(agentEnvPage(m.claudeEnv), { category: "env", refresh: false }) : void 0;
+}
+function lastStart(argv) {
+  const at = argv.indexOf("--harness");
+  const agent = at >= 0 ? argv[at + 1] : argv[0];
+  return agent ?? "last start";
+}
 function agentsOptions(m, cwd = process.cwd()) {
-  const view2 = startView(m);
+  const view = startView(m);
+  const env = envView(m);
+  const commands = commandsView(m);
   return {
     path: [],
     categories: agentCategories(m),
@@ -7785,11 +7899,13 @@ function agentsOptions(m, cwd = process.cwd()) {
           label: "Repeat last",
           category: "start",
           section: "Quick start",
-          hint: Theme.muted(Text.truncate(commandLine(m.last), 50)),
-          description: "Runs the last command again."
+          hint: Theme.muted(Text.truncate(lastStart(m.last), 50)),
+          description: "Starts the same agent again with the same options."
         }
       ] : [],
-      ...view2.items.map((item2) => startRow(item2, m, cwd)),
+      ...view.items.map((item2) => startRow(item2, m, cwd)),
+      ...env?.items ?? [],
+      ...commands.items,
       {
         value: "opt:attach",
         label: "Attach this terminal",
@@ -7843,8 +7959,8 @@ function agentsOptions(m, cwd = process.cwd()) {
         description: "Runs the real " + agent + " on this PC, with no sandbox around it."
       }))
     ],
-    enterLabel: (_category, id) => ENTER[id ?? ""] ?? (id?.startsWith("agent:") ? "start" : id?.startsWith("host:") ? "run" : "open"),
-    actions: (category) => category === "start" ? view2.actions : []
+    enterLabel: (category, id) => ENTER[id ?? ""] ?? (id?.startsWith("agent:") ? "start" : id?.startsWith("host:") ? "run" : category === "host" ? commands.enterLabel(category, id) : "open"),
+    actions: (category) => category === "start" ? view.actions : category === "env" ? env?.actions ?? [] : category === "host" ? commands.actions : []
   };
 }
 var ENTER = {
@@ -7875,7 +7991,7 @@ var AgentsPage = class extends ListPage {
   facts;
   current() {
     if (!this.facts) throw new Error("The agents tab was not loaded");
-    const { agents, commands, last } = this.facts;
+    const { agents, commands, last, env } = this.facts;
     return {
       folder: this.folder,
       defaultAgent: agents.defaultAgent,
@@ -7884,7 +8000,13 @@ var AgentsPage = class extends ListPage {
       attach: this.attach,
       window: this.window,
       hostAgents: hostAgentsToShow(commands.enabled, commands.found),
-      removable: agents.agents.filter((a) => a.removable).map((a) => a.name)
+      agentCommands: {
+        enabled: commands.enabled,
+        dir: commands.dir,
+        found: commands.found.map((a) => ({ command: a.command, harness: a.harness, real: a.real }))
+      },
+      removable: agents.agents.filter((a) => a.removable).map((a) => a.name),
+      ...env ? { claudeEnv: env } : {}
     };
   }
   /** The cursor starts on the default agent. */
@@ -7895,7 +8017,8 @@ var AgentsPage = class extends ListPage {
     this.facts = {
       agents: await readQuery(listAgents, this.ctx),
       commands: await new AgentCommandsService(this.ctx).statusAsync(),
-      last: readHistory()[0]?.argv
+      last: readHistory()[0]?.argv,
+      env: "claude" in this.ctx.loaded.config.harnesses ? await readQuery(agentEnv, this.ctx, { agent: "claude" }) : void 0
     };
     this.model = this.current();
   }
@@ -7905,9 +8028,19 @@ var AgentsPage = class extends ListPage {
   }
   async act(result) {
     const model = this.current();
-    const chosen = startView(model).resolve(result);
+    const env = this.category === "env" ? envView(model) : void 0;
+    if (env) {
+      const picked = env.resolve(result);
+      if (picked?.kind === "action") return this.operate(picked.action);
+      return {};
+    }
+    const chosen = startView(model).resolve(result) ?? commandsView(model).resolve(result);
     if (chosen?.kind === "action") {
       const { action: action2 } = chosen;
+      if (action2.kind === "link" && action2.target.kind === "view") {
+        await this.selectCategory("env");
+        return {};
+      }
       if (action2.kind === "link" && action2.target.kind === "start-agent")
         return { exit: { kind: "run", argv: startArgv(model, action2.target.agent, process.cwd()) } };
       return this.operate(action2);
@@ -8158,15 +8291,14 @@ var CATEGORIES2 = [
   },
   { id: "more", label: "More commands", description: "Less common commands." }
 ];
-var MORE_COMMANDS = ["sync", "config", "generate", "exec", "agent-commands"];
+var MORE_COMMANDS = ["sync", "config", "generate", "exec"];
 var NO_LOGS = { folder: "", files: [], crash: false };
 var NO_WEB = { running: false, port: null, address: null };
 var MORE_LABELS = {
   sync: "Copy history back now",
   config: "Your settings file",
   generate: "Preview a start",
-  exec: "Run a command in the sandbox",
-  "agent-commands": "Agent commands (Beta)"
+  exec: "Run a command in the sandbox"
 };
 function dataMenuView(data) {
   return data ? menuView(dataPage(data), { category: "data", prefix: "data:", refresh: false }) : void 0;
@@ -8205,7 +8337,12 @@ var NO_UPDATES = {
   settings: { pending: [], error: null }
 };
 function logsMenu(files) {
-  return menuView({ ...logsPage(files), empty: void 0 }, { category: "logs", refresh: false });
+  const follow2 = link({ kind: "command", argv: ["logs", "--follow"] }, "Follow the newest log", {
+    key: "f",
+    verb: "follow in the terminal",
+    importance: 2
+  });
+  return menuView({ ...logsPage(files), empty: void 0, actions: [follow2] }, { category: "logs", refresh: false });
 }
 function auditMenu(m) {
   return m.audit ? menuView(auditPage(m.audit), { category: "activity", prefix: "audit:", refresh: false }) : void 0;
@@ -8482,18 +8619,18 @@ var CATEGORIES3 = [
 function statusView(m) {
   return menuView(sandboxPage(m.report), { category: "status", prefix: "status:", refresh: false });
 }
-function projectsView(m) {
+function projectsView2(m) {
   return menuView(projectsPage(m.projects), { category: "projects", refresh: false });
 }
 function viewFor(m, category) {
-  if (category === "projects") return projectsView(m);
+  if (category === "projects") return projectsView2(m);
   if (category === "status" || category === void 0) return statusView(m);
   return void 0;
 }
 function sandboxOptions(m) {
   const running = m.report.sandbox.running;
   const status = statusView(m);
-  const projects = projectsView(m);
+  const projects = projectsView2(m);
   const statusItems = [...running ? [] : startRows(m.defaultAgent, "status"), ...status.items];
   const noDatabases = m.databases ? [] : running ? [
     {
@@ -8623,11 +8760,17 @@ var SandboxPage = class extends ListPage {
 };
 
 // src/cli/menu/pages/sessions-page.ts
-function view(m) {
-  return menuView(sessionsPage({ ...m, wide: false }));
+function sessionsMenu(m) {
+  const resume2 = link({ kind: "command", argv: ["resume"] }, "Reopen last sessions", {
+    key: "o",
+    verb: "reopen last sessions",
+    importance: 2
+  });
+  const page = sessionsPage({ ...m, wide: false });
+  return menuView({ ...page, actions: [...page.actions ?? [], resume2] });
 }
 function sessionsOptions(m) {
-  const v = view(m);
+  const v = sessionsMenu(m);
   return { path: [], items: v.items, actions: v.actions, enterLabel: v.enterLabel };
 }
 var SessionsPage = class extends ListPage {
@@ -8648,7 +8791,7 @@ var SessionsPage = class extends ListPage {
     return sessionsOptions(this.model);
   }
   async act(result) {
-    const chosen = view(this.model).resolve(result);
+    const chosen = sessionsMenu(this.model).resolve(result);
     if (!chosen) return {};
     if (chosen.kind === "refresh") return { reload: true };
     return this.operations.perform(chosen.action, [this.label], (text2) => this.busy(text2));
@@ -8781,10 +8924,22 @@ var SettingsPage = class extends ListPage {
     killSwitch: true,
     login: "none",
     loginSavedAt: null,
-    running: null
+    running: null,
+    lastFailure: null
   };
   /** Whether a GitHub token is saved (never the token): the token row needs only its state. */
-  github = { shareToken: false, gitAccess: "full", token: "none", kind: null, savedAt: null };
+  github = {
+    shareToken: false,
+    gitAccess: "full",
+    token: "none",
+    kind: null,
+    savedAt: null,
+    login: null,
+    expiresAt: null,
+    repoCount: null,
+    checkedAt: null,
+    tokenUrl: ""
+  };
   get file() {
     return this.files[this.scope];
   }
@@ -9057,11 +9212,11 @@ var MenuStateSchema = external_exports.strictObject({
 function stateFile(dir) {
   return new JsonFile(MenuStateSchema, path8.join(dir, "menu-state.json"));
 }
-function viewToState(view2, labels) {
+function viewToState(view, labels) {
   const screens = {};
-  for (const [label, screen] of Object.entries(view2.screens))
+  for (const [label, screen] of Object.entries(view.screens))
     if (labels.includes(label) && (screen.category || screen.search)) screens[label] = screen;
-  return { section: labels[view2.section] ?? labels[0] ?? "", screens };
+  return { section: labels[view.section] ?? labels[0] ?? "", screens };
 }
 function stateToView(state, labels) {
   const section = labels.indexOf(state.section);
@@ -9078,9 +9233,9 @@ function readMenuView(labels, dir = userDir()) {
     return void 0;
   }
 }
-function saveMenuView(view2, labels, dir = userDir()) {
+function saveMenuView(view, labels, dir = userDir()) {
   try {
-    stateFile(dir).write(viewToState(view2, labels));
+    stateFile(dir).write(viewToState(view, labels));
   } catch {
   }
 }
@@ -9101,6 +9256,7 @@ var Shell = class {
     this.draft = draft;
     this.afterSave = afterSave;
     app.nav = () => this.nav();
+    app.goTo = (section, where) => this.goTo(section, where);
   }
   app;
   pages;
@@ -9145,10 +9301,10 @@ var Shell = class {
     return { section: this.active, screens: Object.fromEntries(this.screens) };
   }
   /** Opens the section a view names and puts each section back where it was (what is gone is ignored). */
-  async restore(view2) {
+  async restore(view) {
     this.restored.clear();
-    for (const [label, screen] of Object.entries(view2.screens)) this.screens.set(label, screen);
-    await this.openTab(view2.section);
+    for (const [label, screen] of Object.entries(view.screens)) this.screens.set(label, screen);
+    await this.openTab(view.section);
   }
   /** Opens a section by index (loads its data); the first time, it goes back to the category and search it had. */
   async openTab(index) {
@@ -9163,6 +9319,15 @@ var Shell = class {
       await this.page.selectCategory(wanted.category);
     if (wanted?.search) this.page.restoreSearch?.(wanted.search);
   }
+  /** Opens a section by name, on a category and/or with a search typed (a link from another page). */
+  async goTo(section, where = {}) {
+    const index = this.pages.findIndex((p) => p.label === section);
+    if (index < 0) return;
+    await this.openTab(index);
+    if (where.category) await this.page.selectCategory(where.category);
+    if (where.search) this.page.restoreSearch?.(where.search);
+    this.setFocus("list");
+  }
   /** Puts the keyboard in the navigation or in the list. */
   setFocus(focus) {
     this.focus = focus;
@@ -9311,10 +9476,10 @@ var Menu = class {
   status() {
     const folder = Theme.muted(Text.middle(process.cwd(), 70));
     if (!isSandboxRunning()) return Theme.muted(Theme.glyph.off + " No sandbox running") + "   " + folder;
-    const view2 = lookAtSandbox(this.ctx);
-    if (view2.line)
-      return Theme.ok(Theme.glyph.on + " " + view2.line) + Theme.muted(
-        view2.limited ? ". You can use it when they share it, or start your own after it stops." : ". Its window is on their desktop; use its agents here."
+    const view = lookAtSandbox(this.ctx);
+    if (view.line)
+      return Theme.ok(Theme.glyph.on + " " + view.line) + Theme.muted(
+        view.limited ? ". You can use it when they share it, or start your own after it stops." : ". Its window is on their desktop; use its agents here."
       );
     const n = new SandboxChannel(this.ctx.dataPath).runningSessions().length;
     return Theme.ok(Theme.glyph.on + " Sandbox running") + Theme.muted(" \xB7 " + n + " session" + (n === 1 ? "" : "s")) + "   " + folder;
@@ -9400,7 +9565,7 @@ var Menu = class {
       await pressAnyKey(Theme.muted("Press any key for the menu\u2026"));
     });
   }
-  /** After a save: agent commands (Beta) may have been switched, which changes this PC. */
+  /** After a save: agent commands may have been switched, which changes this PC. */
   applyAgentCommands(saved) {
     if (!saved.files.some((f) => !f.isProject)) return void 0;
     try {
@@ -9408,9 +9573,9 @@ var Menu = class {
         loadConfig(this.ctx.loaded.configPath ?? void 0).config
       );
       if (!result?.changed) return void 0;
-      return result.on ? "Agent commands (Beta) are on: open a new terminal." : "Agent commands are off: claude, codex ... run on this PC again (open a new terminal).";
+      return result.on ? "Agent commands are on: open a new terminal." : "Agent commands are off: claude, codex ... run on this PC again (open a new terminal).";
     } catch (e) {
-      return "Agent commands (Beta): " + errMsg(e);
+      return "Agent commands: " + errMsg(e);
     }
   }
 };
@@ -9800,7 +9965,7 @@ async function logs(ctx) {
 }
 
 // src/cli/commands/maintenance/config.ts
-import { spawn } from "node:child_process";
+import { spawn as spawn2 } from "node:child_process";
 import fs7 from "node:fs";
 import path11 from "node:path";
 import { pathToFileURL } from "node:url";
@@ -9822,7 +9987,7 @@ async function initConfig() {
     if (answer === "cancel") return 0;
     if (answer === "open") {
       refuseInSelfTest("open files");
-      spawn(system32("notepad.exe"), [file], { detached: true, stdio: "ignore" }).unref();
+      spawn2(system32("notepad.exe"), [file], { detached: true, stdio: "ignore" }).unref();
       console.log("Opened " + file + ".");
       return 0;
     }
@@ -10055,30 +10220,30 @@ var RemoteMenu = class {
       });
       if (picked.kind !== "pick") return;
       at = picked.value;
-      const view2 = views.find((v) => v.id === picked.value);
-      if (view2) await this.showView(view2);
+      const view = views.find((v) => v.id === picked.value);
+      if (view) await this.showView(view);
     }
   }
-  async page(view2) {
-    const inputs = viewInputs(view2, {});
+  async page(view) {
+    const inputs = viewInputs(view, {});
     const data = {};
-    for (const [name, query] of Object.entries(view2.queries))
+    for (const [name, query] of Object.entries(view.queries))
       data[name] = await this.client.run(query.id, inputs[name], NO_QUESTIONS);
-    return view2.build(data, {});
+    return view.build(data, {});
   }
-  async showView(view2) {
+  async showView(view) {
     let notice;
     for (; ; ) {
       let page;
       try {
-        page = await this.page(view2);
+        page = await this.page(view);
       } catch (e) {
-        await this.app.message({ path: [this.title(), view2.title], lines: [safeText(errMsg(e))], tone: "error" });
+        await this.app.message({ path: [this.title(), view.title], lines: [safeText(errMsg(e))], tone: "error" });
         return;
       }
       const mv = menuView(page);
       const result = await this.app.list({
-        path: [this.title(), view2.title],
+        path: [this.title(), view.title],
         intro: page.notice ? [safeText(page.notice.text)] : void 0,
         items: mv.items,
         actions: mv.actions,
@@ -10092,10 +10257,10 @@ var RemoteMenu = class {
       if (!chosen || chosen.kind === "refresh") continue;
       const action2 = chosen.action;
       if (action2.kind === "link") {
-        notice = action2.target.kind === "terminal" ? Theme.muted("Attach to it from your own terminal: sandbox attach " + safeText(action2.target.session)) : Theme.muted("That opens on " + safeText(this.owner) + "'s side only.");
+        notice = action2.target.kind === "terminal" ? Theme.muted("Attach to it from your own terminal (session " + safeText(action2.target.session) + ").") : Theme.muted("That opens on " + safeText(this.owner) + "'s side only.");
         continue;
       }
-      const done = await this.operations.perform(action2, [this.title(), view2.title], (text2) => {
+      const done = await this.operations.perform(action2, [this.title(), view.title], (text2) => {
         notice = text2;
         this.app.redraw();
       });
@@ -10282,7 +10447,6 @@ var HANDLERS = {
   generate: (ctx) => launch(ctx, true),
   attach,
   exec,
-  "agent-commands": agentCommandsCommand,
   db,
   resume,
   // The bare command lists; its actions (save, use ...) are the operations' hints.
@@ -10317,6 +10481,8 @@ var HANDLERS = {
   "host-claude": claudeHost,
   host: hostCommand,
   _watch: watcher,
+  // The bare command shows the status; on and off are the operations' hints (src/app/features/agent-commands).
+  "agent-commands": definitionHandler(agentCommandsStatus),
   vpn,
   github,
   web,
@@ -10364,6 +10530,7 @@ function report(e) {
   if (e instanceof UserError) {
     console.error(c.red("Error: ") + plainText(e.message));
     if (e.fix) console.error("  Fix:  " + plainText(e.fix));
+    if (e.action?.cli) console.error("  Run:  " + plainText(e.action.cli));
     return 1;
   }
   console.error(c.red("Unexpected error: ") + errMsg(e));