windows-development-sandbox 1.20.0 → 1.23.1

package/dist/bin/claude-host.js

@@ -2,8 +2,8 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   run
-} from "./chunk-DK4NTBUF.js";
-import "./chunk-Z2P5OGKL.js";
+} from "./chunk-7YPEDAJD.js";
+import "./chunk-USTRSHIE.js";
 
 // src/bin/claude-host.ts
 var args = process.argv.slice(2);

package/dist/bin/claude-sbx.js

@@ -2,8 +2,8 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   run
-} from "./chunk-DK4NTBUF.js";
-import "./chunk-Z2P5OGKL.js";
+} from "./chunk-7YPEDAJD.js";
+import "./chunk-USTRSHIE.js";
 
 // src/bin/claude-sbx.ts
 run(process.argv.slice(2), { harness: "claude" });

package/dist/bin/codex-sbx.js

@@ -2,8 +2,8 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   run
-} from "./chunk-DK4NTBUF.js";
-import "./chunk-Z2P5OGKL.js";
+} from "./chunk-7YPEDAJD.js";
+import "./chunk-USTRSHIE.js";
 
 // src/bin/codex-sbx.ts
 run(process.argv.slice(2), { harness: "codex" });

package/dist/bin/gemini-sbx.js

@@ -2,8 +2,8 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   run
-} from "./chunk-DK4NTBUF.js";
-import "./chunk-Z2P5OGKL.js";
+} from "./chunk-7YPEDAJD.js";
+import "./chunk-USTRSHIE.js";
 
 // src/bin/gemini-sbx.ts
 run(process.argv.slice(2), { harness: "gemini" });

package/dist/bin/sandbox.js

@@ -2,8 +2,8 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   run
-} from "./chunk-DK4NTBUF.js";
-import "./chunk-Z2P5OGKL.js";
+} from "./chunk-7YPEDAJD.js";
+import "./chunk-USTRSHIE.js";
 
 // src/bin/sandbox.ts
 run(process.argv.slice(2));

package/dist/bin/sbx-hide.js

@@ -2,8 +2,8 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   run
-} from "./chunk-DK4NTBUF.js";
-import "./chunk-Z2P5OGKL.js";
+} from "./chunk-7YPEDAJD.js";
+import "./chunk-USTRSHIE.js";
 
 // src/bin/sbx-hide.ts
 run(process.argv.slice(2), { command: "hide" });

package/dist/bin/sbx-show.js

@@ -2,8 +2,8 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   run
-} from "./chunk-DK4NTBUF.js";
-import "./chunk-Z2P5OGKL.js";
+} from "./chunk-7YPEDAJD.js";
+import "./chunk-USTRSHIE.js";
 
 // src/bin/sbx-show.ts
 run(process.argv.slice(2), { command: "show" });

package/dist/cli/manifest.d.ts

@@ -296,7 +296,7 @@ declare const COMMAND_LIST: readonly [{
     readonly name: "account";
     readonly summary: "agent logins (list, save, use, default, remove) and service sign-ins (status, import, login, logout)";
     readonly group: "Projects & accounts";
-    readonly examples: readonly ["sandbox account save work          save the login you signed in with inside the sandbox", "sandbox account use work           the sandbox uses it (running sessions restart)", "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 logout steam       forget a service sign-in", "sandbox account save free --api-key   save an Anthropic API key you paste in (not shown)"];
+    readonly examples: readonly ["sandbox account save work          save the login you signed in with inside the sandbox", "sandbox account use work           the sandbox uses it (running sessions restart)", "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)"];
     readonly args: readonly [{
         readonly name: "action";
         readonly description: "what to do";
@@ -304,7 +304,7 @@ declare const COMMAND_LIST: readonly [{
         readonly choices: readonly ["list", "save", "use", "default", "rename", "remove"];
     }, {
         readonly name: "name";
-        readonly description: "account name, or the service (status, import, login, logout): epic, steam, unity, cfx, keystore, play, expo or appstore";
+        readonly description: "account name, or the service (status, import, login, logout): epic, steam, unity, cfx, keystore, play, expo, appstore, perplexity or comet";
         readonly required: false;
         readonly choices: "accounts";
     }];

package/dist/cli/manifest.js

@@ -286,6 +286,7 @@ const 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)',
         ],
@@ -298,7 +299,7 @@ const 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',
             },

package/dist/cli/menu/coverage-exempt.d.ts

@@ -0,0 +1,17 @@
+import type { SECTION_LABELS } from './shell.js';
+type Section = (typeof SECTION_LABELS)[number];
+export type CommandPlace = {
+    readonly place: `${Section}${string}`;
+} | {
+    readonly exempt: string;
+};
+/** Every command of cli/manifest.ts (hand-written and from the shared core's CLI hints). */
+export declare const COMMAND_PLACES: Readonly<Record<string, CommandPlace>>;
+/**
+ * Operations and queries that declare `surfaces.except.menu`: the id and why the menu does without them. A definition
+ * with a menu exemption that is not here fails the coverage test.
+ */
+export declare const MENU_EXEMPT: Readonly<Record<string, string>>;
+/** Setting keys (or key prefixes ending in a dot) the menu's Settings page does not list as a row. */
+export declare const SETTING_PLACES: Readonly<Record<string, string>>;
+export {};

package/dist/cli/menu/coverage-exempt.js

@@ -0,0 +1,61 @@
+/** Every command of cli/manifest.ts (hand-written and from the shared core's CLI hints). */
+export const COMMAND_PLACES = {
+    launch: { place: 'Agents > Start (with the options of the tab)' },
+    start: { place: 'Agents > Start several' },
+    generate: { place: 'Maintenance > More commands' },
+    attach: { place: 'Sessions (Enter on a session)' },
+    resume: { place: 'Sessions (key o: reopen last sessions)' },
+    db: { place: 'Sandbox > Databases' },
+    exec: { place: 'Maintenance > More commands' },
+    projects: { place: 'Sandbox > Projects' },
+    account: { place: 'Accounts' },
+    data: { place: 'Maintenance > Data' },
+    storage: { place: 'Maintenance > Storage' },
+    engine: { place: 'Maintenance > Engine' },
+    sync: { place: 'Maintenance > More commands' },
+    logs: { place: 'Maintenance > Logs (key f follows)' },
+    setup: { place: 'Maintenance > Health' },
+    doctor: { place: 'Maintenance > Health' },
+    repair: { place: 'Maintenance > Health' },
+    'self-test': { exempt: 'a developer check that refuses to run outside a throwaway machine' },
+    config: { place: 'Settings (every setting) and Maintenance > More commands' },
+    'agent-commands': { place: 'Agents > Agent commands' },
+    vpn: { place: 'Settings > Network > VPN' },
+    github: { place: 'Accounts > GitHub (and Settings > Security)' },
+    'host-claude': { place: 'Agents > On this PC' },
+    host: { place: 'Agents > On this PC' },
+    menu: { exempt: 'it is the menu' },
+    web: { place: 'Maintenance > Web UI' },
+    remote: { exempt: "it opens this menu on another Windows user's web UI: the menu cannot start itself inside itself" },
+    _watch: { exempt: 'internal: the background history sync' },
+    _web: { exempt: 'internal: the web server process' },
+    show: { place: 'Sandbox > Status' },
+    hide: { place: 'Sandbox > Status' },
+    stop: { place: 'Sandbox > Status' },
+    cleanup: { place: 'Sandbox > Status (when a dead sandbox left programs behind)' },
+    restart: { place: 'Sessions (key r)' },
+    shell: { place: 'Sessions (key s)' },
+    close: { place: 'Sessions' },
+    clean: { place: 'Maintenance > Data' },
+    update: { place: 'Maintenance > Updates' },
+    migrate: { place: 'Maintenance > Updates' },
+    status: { place: 'Sandbox > Status' },
+    sessions: { place: 'Sessions' },
+    audit: { place: 'Maintenance > Activity' },
+};
+/**
+ * Operations and queries that declare `surfaces.except.menu`: the id and why the menu does without them. A definition
+ * with a menu exemption that is not here fails the coverage test.
+ */
+export const MENU_EXEMPT = {
+    'agents.start': 'the menu starts agents with launch, which can boot the sandbox and attach this terminal',
+    'engine.check': 'the Engine category shows every engine and its check with the fixes (engine.status)',
+    'files.browse': 'the menu asks for a path as text and checks it',
+    'settings.get': 'Settings shows every value',
+};
+/** Setting keys (or key prefixes ending in a dot) the menu's Settings page does not list as a row. */
+export const SETTING_PLACES = {
+    'apps.install': 'the Apps section (a tick per app)',
+    'apps.custom': 'the Apps section (your own apps)',
+    $schema: 'not a setting: the JSON schema address of the file',
+};

package/dist/cli/menu/io-menu.d.ts

@@ -22,6 +22,8 @@ export declare class MenuOperations {
     perform(action: Action, where: Where, busy?: ShowBusy, onOutput?: (output: unknown) => void): Promise<Performed>;
     /** The values of an action's fields, from the editors that fit them (undefined: one was backed out of). */
     private fields;
+    /** A failure that names a fix: a dialog with the fix as a button; its result replaces the failure notice. */
+    private offerFix;
     /**
      * 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).

package/dist/cli/menu/io-menu.js

@@ -5,10 +5,13 @@
 import { operationById } from '../../app/features/defs.js';
 import { runDefinition } from '../../app/registry.js';
 import { Cancelled, ioFromAsker, SchemaNode, toWireError, } from '../../app/kernel/index.js';
+import { spawn } from 'node:child_process';
 import { errMsg } from '../../core/util/index.js';
+import { SYSTEM } from '../../shared/system.js';
 import { Theme } from '../tui/index.js';
 import { askPath } from './settings/ask-path.js';
 import { ValueEditor } from './settings/value-editor.js';
+import { MENU_VIEWS } from './views.js';
 async function ask(app, where, q, said) {
     const lines = [...said, ...(q.lines ?? []), ...('problem' in q && q.problem ? [Theme.warn(q.problem)] : [])];
     const path = [...where];
@@ -51,8 +54,27 @@ async function ask(app, where, q, said) {
             });
     }
 }
+/** The menu section (and category) that shows a view, for a link to it. */
+function placeOf(view) {
+    const place = MENU_VIEWS.find((m) => m.view.id === view);
+    if (!place)
+        return undefined;
+    return { section: place.section, ...(view === 'agentEnv' ? { category: 'env' } : {}) };
+}
+/** Opens a page in the browser (https://github.com/ only). */
+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', () => undefined);
+    child.unref();
+}
 /** Where a link goes in the menu: what needs the terminal is run on the normal screen. */
-function follow(target) {
+function follow(target, app) {
     switch (target.kind) {
         case 'terminal':
             return { exit: { kind: 'run', argv: ['attach', target.session] } };
@@ -60,8 +82,19 @@ 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.') };
     }
 }
 export class MenuOperations {
@@ -74,7 +107,7 @@ export class MenuOperations {
     /** Does what an action of a page says: follows a link, or asks for its fields and runs its operation. */
     async perform(action, where, busy, onOutput) {
         if (action.kind === 'link')
-            return follow(action.target);
+            return follow(action.target, this.app);
         const def = operationById(action.op);
         if (!def)
             return { notice: Theme.error(Theme.glyph.cross + ' Unknown operation ' + action.op + '.') };
@@ -105,6 +138,17 @@ export class MenuOperations {
         }
         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) : undefined;
+        if (!fix || !def)
+            return undefined;
+        const yes = await this.app.ask(problem.message, problem.fix ? [problem.fix] : [], fix.label);
+        if (!yes)
+            return undefined;
+        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).
@@ -129,7 +173,8 @@ export class MenuOperations {
             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;
         }
     }
 }

package/dist/cli/menu/pages/accounts-page.js

@@ -33,7 +33,7 @@ export 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: [

package/dist/cli/menu/pages/agents-page.js

@@ -107,6 +107,12 @@ function startRow(item, m, cwd) {
 function envView(m) {
     return m.claudeEnv ? menuView(agentEnvPage(m.claudeEnv), { category: 'env', refresh: false }) : undefined;
 }
+/** What the last start was, in words: the agent and the folder it was for (never the command line). */
+function lastStart(argv) {
+    const at = argv.indexOf('--harness');
+    const agent = at >= 0 ? argv[at + 1] : argv[0];
+    return agent ?? 'last start';
+}
 /** The list for the agents section. Pure. */
 export function agentsOptions(m, cwd = process.cwd()) {
     const view = startView(m);
@@ -123,8 +129,8 @@ export 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.',
                     },
                 ]
                 : []),

package/dist/cli/menu/pages/maintenance-page.d.ts

@@ -8,6 +8,7 @@ import { type UpdatesStatus } from '../../../app/features/updates/updates.def.js
 import { type WebStatus } from '../../../app/features/web/index.js';
 import type { Context } from '../../commands/context.js';
 import { type App, type ListOptions, type ListResult } from '../../tui/index.js';
+import { type MenuView } from '../render-view.js';
 import { ListPage, type Outcome } from './list-page.js';
 export interface MaintenanceModel {
     /** The Data & storage category's storage rows: the data folder and contained storage (null until read). */
@@ -42,6 +43,11 @@ export interface MaintenanceModel {
         summary: string;
     }[];
 }
+/**
+ * The logs view's rows and keys for the Logs category (its own empty row is left out: the category shows the page's
+ * "Nothing here yet.").
+ */
+export declare function logsMenu(files: LogFiles): MenuView;
 /** The list for the maintenance tab. Pure. */
 export declare function maintenanceOptions(m: MaintenanceModel): ListOptions<string>;
 export declare class MaintenancePage extends ListPage<string> {

package/dist/cli/menu/pages/maintenance-page.js

@@ -2,6 +2,7 @@
 // what is stored, clean-up), Health (doctor, repair and this PC's setup together), Activity (the audit log), the logs,
 // and the less common commands. Each is a category on the left and loads when you open it.
 import { dataPage, showData } from '../../../app/features/data/index.js';
+import { link } from '../../../app/kernel/index.js';
 import { readQuery } from '../../../app/registry.js';
 import { errMsg } from '../../../core/util/index.js';
 import { enginePage, engineLeftovers, engineStatus, } from '../../../app/features/engine/index.js';
@@ -108,8 +109,14 @@ const NO_UPDATES = {
  * The logs view's rows and keys for the Logs category (its own empty row is left out: the category shows the page's
  * "Nothing here yet.").
  */
-function logsMenu(files) {
-    return menuView({ ...logsPage(files), empty: undefined }, { category: 'logs', refresh: false });
+export function logsMenu(files) {
+    // Following a log runs the hand-written `logs --follow` on the normal screen: a menu key, not a page link.
+    const follow = link({ kind: 'command', argv: ['logs', '--follow'] }, 'Follow the newest log', {
+        key: 'f',
+        verb: 'follow in the terminal',
+        importance: 2,
+    });
+    return menuView({ ...logsPage(files), empty: undefined, actions: [follow] }, { category: 'logs', refresh: false });
 }
 /** The audit view (src/app/features/audit) as the Activity category's rows and keys (none until it was read). */
 function auditMenu(m) {

package/dist/cli/menu/pages/sessions-page.d.ts

@@ -1,9 +1,11 @@
 import { type SessionsList } from '../../../app/features/sessions/index.js';
 import type { Context } from '../../commands/context.js';
 import type { App, ListOptions, ListResult } from '../../tui/index.js';
+import { type MenuView } from '../render-view.js';
 import { ListPage, type Outcome } from './list-page.js';
 /** What the page shows: the sessions query's result (the folder column is never shown here). */
 export type SessionsModel = Omit<SessionsList, 'wide'>;
+export declare function sessionsMenu(m: SessionsModel): MenuView;
 /** The list for the sessions tab. Pure. */
 export declare function sessionsOptions(m: SessionsModel): ListOptions<string>;
 export declare class SessionsPage extends ListPage<string> {

package/dist/cli/menu/pages/sessions-page.js

@@ -1,16 +1,24 @@
 // Section 2: the agent sessions of the running sandbox, as the sessions view shows them (src/app/features/sessions).
 // Enter shows one in this terminal (the one thing that leaves the menu), r restarts the agents.
+import { link } from '../../../app/kernel/index.js';
 import { listSessions, sessionsPage } from '../../../app/features/sessions/index.js';
 import { readQuery } from '../../../app/registry.js';
 import { MenuOperations } from '../io-menu.js';
 import { menuView } from '../render-view.js';
 import { ListPage } from './list-page.js';
-function view(m) {
-    return menuView(sessionsPage({ ...m, wide: false }));
+export function sessionsMenu(m) {
+    // Reopening the last sessions runs the hand-written `resume` on the normal screen: a key of the menu, not a link.
+    const resume = 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 ?? []), resume] });
 }
 /** The list for the sessions tab. Pure. */
 export function sessionsOptions(m) {
-    const v = view(m);
+    const v = sessionsMenu(m);
     return { path: [], items: v.items, actions: v.actions, enterLabel: v.enterLabel };
 }
 export class SessionsPage extends ListPage {
@@ -31,7 +39,7 @@ export class SessionsPage 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')

package/dist/cli/menu/pages/settings-page.js

@@ -161,7 +161,18 @@ export class SettingsPage extends ListPage {
         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: '',
+    };
     constructor(app, files, draft, ctx) {
         super(app);
         this.files = files;

package/dist/cli/menu/remote-menu.js

@@ -94,7 +94,7 @@ export class RemoteMenu {
             if (action.kind === 'link') {
                 notice =
                     action.target.kind === 'terminal'
-                        ? Theme.muted('Attach to it from your own terminal: sandbox attach ' + safeText(action.target.session))
+                        ? Theme.muted('Attach to it from your own terminal (session ' + safeText(action.target.session) + ').')
                         : Theme.muted('That opens on ' + safeText(this.owner) + "'s side only.");
                 continue;
             }

package/dist/cli/menu/shell.d.ts

@@ -82,6 +82,11 @@ export declare class Shell implements Screen<ShellExit> {
     restore(view: MenuView): Promise<void>;
     /** Opens a section by index (loads its data); the first time, it goes back to the category and search it had. */
     openTab(index: number): Promise<void>;
+    /** Opens a section by name, on a category and/or with a search typed (a link from another page). */
+    goTo(section: string, where?: {
+        category?: string;
+        search?: string;
+    }): Promise<void>;
     /** Puts the keyboard in the navigation or in the list. */
     setFocus(focus: 'nav' | 'list'): void;
     /** Loads the open section again (after a command ran). */

package/dist/cli/menu/shell.js

@@ -27,6 +27,7 @@ export class Shell {
         this.draft = draft;
         this.afterSave = afterSave;
         app.nav = () => this.nav();
+        app.goTo = (section, where) => this.goTo(section, where);
     }
     get page() {
         return this.pages[this.active];
@@ -86,6 +87,18 @@ export class Shell {
         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;

package/dist/cli/report.js

@@ -41,6 +41,8 @@ export function report(e) {
         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));

package/dist/cli/tui/app.d.ts

@@ -19,6 +19,11 @@ export declare class App {
     onKey: () => void;
     /** The navigation on the left of every screen (none: no navigation column). */
     nav: () => NavState | undefined;
+    /** Opens another section of the menu (the shell sets it): what a link to a setting or a view does. */
+    goTo: (section: string, where?: {
+        category?: string;
+        search?: string;
+    }) => Promise<void>;
     /** The screens being shown, innermost last: a dialog is drawn over the one below it. */
     private readonly shown;
     private redrawNow;

package/dist/cli/tui/app.js

@@ -25,6 +25,8 @@ export class App {
     onKey = () => undefined;
     /** The navigation on the left of every screen (none: no navigation column). */
     nav = () => undefined;
+    /** 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;

package/dist/core/config/defaults.js

@@ -55,6 +55,8 @@ export const DEFAULTS = {
         play: { share: false },
         expo: { share: false },
         appstore: { share: false },
+        perplexity: { share: false },
+        comet: { share: false },
     },
     pcInstalls: { steamGames: false, epicGames: false, unrealEngines: false, unityEditors: false },
     provisioning: {
@@ -192,7 +194,7 @@ export const DEFAULTS = {
             npmBin: 'codex',
             arguments: [],
             environment: {},
-            home: { env: { CODEX_HOME: 'codex' }, loginFiles: ['auth.json'], hostDir: '~/.codex' },
+            home: { env: { CODEX_HOME: 'codex' }, loginFiles: ['auth.json', '.credentials.json'], hostDir: '~/.codex' },
             localState: { CODEX_SQLITE_HOME: 'sqlite' },
             // Its own command sandbox keeps local users' passwords sealed with DPAPI: unreadable in the next sandbox
             // ("CryptUnprotectData" on every command), so it sets that sandbox up again at each boot. tmp\arg0: folders

package/dist/core/schema/accounts.d.ts

@@ -24,4 +24,10 @@ export declare const AccountsSchema: z.ZodObject<{
     appstore: z.ZodObject<{
         share: z.ZodBoolean;
     }, z.core.$strict>;
+    perplexity: z.ZodObject<{
+        share: z.ZodBoolean;
+    }, z.core.$strict>;
+    comet: z.ZodObject<{
+        share: z.ZodBoolean;
+    }, z.core.$strict>;
 }, z.core.$strict>;

package/dist/core/schema/accounts.js

@@ -1,7 +1,7 @@
 // accounts: which saved service sign-ins sandboxes get (the sign-ins themselves are not settings: they are kept
 // encrypted by `sandbox account import|login`, or come back from a sandbox you signed in in).
 import { z } from 'zod';
-import { SERVICE_SPECS } from '../../shared/accounts/kinds.js';
+import { SERVICE_SPECS, usedByText } from '../../shared/accounts/kinds.js';
 function share(kind, how) {
     const spec = SERVICE_SPECS[kind];
     return z.strictObject({
@@ -10,7 +10,7 @@ function share(kind, how) {
             .describe('Hand your saved ' +
             spec.label +
             ' sign-in to sandboxes that use ' +
-            spec.usedBy.join(' or ') +
+            usedByText(spec.usedBy) +
             ' (' +
             how +
             '). Kept encrypted on this PC; ' +
@@ -20,13 +20,15 @@ function share(kind, how) {
 }
 export const AccountsSchema = z
     .strictObject({
-    epic: share('epic', "sign in to the launcher once in a sandbox, or take this PC's: sandbox account import epic"),
-    steam: share('steam', 'sign in once with sbx-steam login, or: sandbox account import steam --from <steamcmd folder>'),
-    unity: share('unity', "sign in once in a sandbox, or take this PC's licence: sandbox account import unity"),
-    cfx: share('cfx', 'sandbox account login cfx'),
-    keystore: share('keystore', 'sandbox account import keystore --from <upload.jks>'),
-    play: share('play', 'sandbox account import play --from <service-account.json>'),
-    expo: share('expo', 'sandbox account login expo'),
-    appstore: share('appstore', 'sandbox account import appstore --from <AuthKey.p8>'),
+    epic: share('epic', "sign in to the launcher once in a sandbox, or take this PC's from Accounts"),
+    steam: share('steam', 'sign in once with sbx-steam login, or take it from a SteamCMD folder in Accounts'),
+    unity: share('unity', "sign in once in a sandbox, or take this PC's licence from Accounts"),
+    cfx: share('cfx', 'type the key in Accounts'),
+    keystore: share('keystore', 'import the upload.jks file in Accounts'),
+    play: share('play', 'import the service-account.json file in Accounts'),
+    expo: share('expo', 'type the token in Accounts'),
+    appstore: share('appstore', 'import the AuthKey.p8 file in Accounts'),
+    perplexity: share('perplexity', 'type the API key in Accounts, or import it from a .env file'),
+    comet: share('comet', 'sign in to Comet once in a sandbox: it cannot be taken from this PC'),
 })
-    .describe('Service sign-ins for sandboxes (game stores, engines, app signing). Manage them in Accounts: sandbox account status.');
+    .describe('Service sign-ins for sandboxes (game stores, engines, app signing, Perplexity). Manage them in Accounts.');