windows-development-sandbox 1.5.0 → 1.9.0

package/dist/cli/manifest.d.ts

@@ -20,6 +20,8 @@ export declare const OptionSpecSchema: z.ZodObject<{
     advanced: z.ZodOptional<z.ZodBoolean>;
     when: z.ZodOptional<z.ZodString>;
     noMenu: z.ZodOptional<z.ZodBoolean>;
+    group: z.ZodOptional<z.ZodString>;
+    shownAs: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export declare const ArgSpecSchema: z.ZodObject<{
     name: z.ZodString;
@@ -31,30 +33,31 @@ export declare const ArgSpecSchema: z.ZodObject<{
         sessions: "sessions";
         accounts: "accounts";
     }>]>>;
+    aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
     when: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
 }, z.core.$strict>;
 /** Is an argument or option with this `when` asked, given the first argument's answer? */
 export declare function askedWhen(when: string | string[] | undefined, first: string): boolean;
 export declare const GroupSchema: z.ZodEnum<{
     Agents: "Agents";
-    Sandbox: "Sandbox";
     Sessions: "Sessions";
-    Accounts: "Accounts";
+    "Projects & accounts": "Projects & accounts";
     Data: "Data";
+    Web: "Web";
     Health: "Health";
-    Config: "Config";
+    Advanced: "Advanced";
 }>;
 export declare const CommandSpecSchema: z.ZodObject<{
     name: z.ZodString;
     summary: z.ZodString;
     group: z.ZodEnum<{
         Agents: "Agents";
-        Sandbox: "Sandbox";
         Sessions: "Sessions";
-        Accounts: "Accounts";
+        "Projects & accounts": "Projects & accounts";
         Data: "Data";
+        Web: "Web";
         Health: "Health";
-        Config: "Config";
+        Advanced: "Advanced";
     }>;
     args: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -66,6 +69,7 @@ export declare const CommandSpecSchema: z.ZodObject<{
             sessions: "sessions";
             accounts: "accounts";
         }>]>>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
         when: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     }, z.core.$strict>>;
     options: z.ZodArray<z.ZodObject<{
@@ -89,6 +93,8 @@ export declare const CommandSpecSchema: z.ZodObject<{
         advanced: z.ZodOptional<z.ZodBoolean>;
         when: z.ZodOptional<z.ZodString>;
         noMenu: z.ZodOptional<z.ZodBoolean>;
+        group: z.ZodOptional<z.ZodString>;
+        shownAs: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     passthrough: z.ZodOptional<z.ZodEnum<{
         command: "command";
@@ -97,6 +103,7 @@ export declare const CommandSpecSchema: z.ZodObject<{
     json: z.ZodOptional<z.ZodBoolean>;
     interactive: z.ZodOptional<z.ZodBoolean>;
     hidden: z.ZodOptional<z.ZodBoolean>;
+    examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 export type OptionSpec = z.output<typeof OptionSpecSchema>;
 export type ArgSpec = z.output<typeof ArgSpecSchema>;
@@ -118,13 +125,16 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }[];
     readonly passthrough: "agent";
     readonly interactive: true;
+    readonly examples: readonly ["sandbox claude -t                  start Claude here and attach this terminal", "sandbox launch --agent codex       start Codex in the current folder", "sandbox launch --session claude@C:\\code\\api --session \"codex@C:\\code\\web|--model o3\"", "                                   two sessions at once (after | = that agent's own arguments)"];
 }, {
     readonly name: "start";
     readonly summary: "start a sandbox with no agent (tools and databases only)";
-    readonly group: "Sandbox";
+    readonly group: "Agents";
     readonly args: readonly [];
     readonly options: {
         flag: string;
@@ -138,12 +148,14 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }[];
     readonly interactive: true;
 }, {
     readonly name: "generate";
     readonly summary: "show what a start would do, without starting anything";
-    readonly group: "Health";
+    readonly group: "Advanced";
     readonly args: readonly [];
     readonly options: {
         flag: string;
@@ -157,6 +169,8 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }[];
     readonly passthrough: "agent";
 }, {
@@ -174,7 +188,7 @@ declare const COMMAND_LIST: readonly [{
 }, {
     readonly name: "resume";
     readonly summary: "reopen the sessions from the last sandbox";
-    readonly group: "Sessions";
+    readonly group: "Agents";
     readonly args: readonly [];
     readonly options: readonly [{
         flag: string;
@@ -188,25 +202,13 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }];
-}, {
-    readonly name: "sessions";
-    readonly summary: "list agent sessions and who is attached";
-    readonly group: "Sessions";
-    readonly args: readonly [];
-    readonly options: readonly [];
-    readonly json: true;
-}, {
-    readonly name: "status";
-    readonly summary: "show what the sandbox is doing";
-    readonly group: "Sandbox";
-    readonly args: readonly [];
-    readonly options: readonly [];
-    readonly json: true;
 }, {
     readonly name: "db";
     readonly summary: "list, start or stop databases in the running sandbox";
-    readonly group: "Sandbox";
+    readonly group: "Sessions";
     readonly args: readonly [{
         readonly name: "action";
         readonly description: "list, start or stop";
@@ -222,7 +224,8 @@ declare const COMMAND_LIST: readonly [{
 }, {
     readonly name: "exec";
     readonly summary: "run a command inside the sandbox and print its output";
-    readonly group: "Sandbox";
+    readonly group: "Sessions";
+    readonly examples: readonly ["sandbox exec -- npm test            run a command in the running sandbox", "sandbox exec --json -- node -v      the result as JSON"];
     readonly args: readonly [{
         readonly name: "command";
         readonly description: "command and its arguments";
@@ -247,62 +250,17 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }];
     readonly passthrough: "command";
     readonly json: true;
-}, {
-    readonly name: "restart";
-    readonly summary: "restart this project's running agents in place; they resume their conversation";
-    readonly group: "Sessions";
-    readonly args: readonly [];
-    readonly options: readonly [{
-        flag: string;
-        type: "string" | "number" | "boolean" | "list";
-        description: string;
-        short?: string | undefined;
-        value?: string | undefined;
-        label?: string | undefined;
-        default?: string | number | undefined;
-        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
-        advanced?: boolean | undefined;
-        when?: string | undefined;
-        noMenu?: boolean | undefined;
-    }, {
-        flag: string;
-        type: "string" | "number" | "boolean" | "list";
-        description: string;
-        short?: string | undefined;
-        value?: string | undefined;
-        label?: string | undefined;
-        default?: string | number | undefined;
-        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
-        advanced?: boolean | undefined;
-        when?: string | undefined;
-        noMenu?: boolean | undefined;
-    }];
-}, {
-    readonly name: "stop";
-    readonly summary: "shut the sandbox down (every project's sessions end)";
-    readonly group: "Sandbox";
-    readonly args: readonly [];
-    readonly options: readonly [{
-        flag: string;
-        type: "string" | "number" | "boolean" | "list";
-        description: string;
-        short?: string | undefined;
-        value?: string | undefined;
-        label?: string | undefined;
-        default?: string | number | undefined;
-        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
-        advanced?: boolean | undefined;
-        when?: string | undefined;
-        noMenu?: boolean | undefined;
-    }];
 }, {
     readonly name: "projects";
     readonly summary: "the projects a sandbox can open without a restart: list, choose, roots, all/exclude";
-    readonly group: "Sandbox";
+    readonly group: "Projects & accounts";
     readonly json: true;
+    readonly examples: readonly ["sandbox projects                   list your projects", "sandbox projects add .             remember this folder", "sandbox projects roots add C:\\code   share every project in C:\\code"];
     readonly args: readonly [{
         readonly name: "action";
         readonly description: "list, choose, add, remove, include, exclude, all, roots";
@@ -319,23 +277,26 @@ declare const COMMAND_LIST: readonly [{
         readonly required: false;
         readonly when: "roots";
     }];
-    readonly options: readonly [];
-}, {
-    readonly name: "show";
-    readonly summary: "show the sandbox window";
-    readonly group: "Sandbox";
-    readonly args: readonly [];
-    readonly options: readonly [];
-}, {
-    readonly name: "hide";
-    readonly summary: "hide the sandbox window (it keeps running)";
-    readonly group: "Sandbox";
-    readonly args: readonly [];
-    readonly options: readonly [];
+    readonly options: readonly [{
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        label?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
+    }];
 }, {
     readonly name: "account";
     readonly summary: "Claude logins: list, save, use, set the default, remove";
-    readonly group: "Accounts";
+    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)"];
     readonly args: readonly [{
         readonly name: "action";
         readonly description: "what to do";
@@ -359,6 +320,8 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }, {
         flag: string;
         type: "string" | "number" | "boolean" | "list";
@@ -371,6 +334,8 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }, {
         flag: string;
         type: "string" | "number" | "boolean" | "list";
@@ -383,6 +348,8 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }, {
         flag: string;
         type: "string" | "number" | "boolean" | "list";
@@ -395,6 +362,22 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        label?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }];
     readonly json: true;
 }, {
@@ -406,6 +389,7 @@ declare const COMMAND_LIST: readonly [{
         readonly description: "show or clean";
         readonly required: false;
         readonly choices: readonly ["show", "clean"];
+        readonly aliases: readonly ["info", "list", "remove"];
     }, {
         readonly name: "targets";
         readonly description: "what to clean, e.g. tools/go databases logs";
@@ -425,7 +409,75 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
+    }];
+    readonly json: true;
+    readonly examples: readonly ["sandbox data clean                 pick what to delete from a list", "sandbox data clean logs tools/go   delete these"];
+}, {
+    readonly name: "storage";
+    readonly summary: "where your saved data lives: show it, move it to another folder, switch folders, or (beta) keep it in a disk image";
+    readonly group: "Data";
+    readonly examples: readonly ["sandbox storage                    where the data is", "sandbox storage move D:\\sandbox-data   move it (asks first)", "sandbox storage contained status   (beta) the disk image for tools, state and logs", "sandbox storage contained on       (beta) keep them in a disk image (asks first)"];
+    readonly args: readonly [{
+        readonly name: "action";
+        readonly description: "show, move, use or contained";
+        readonly required: false;
+        readonly choices: readonly ["show", "move", "use", "contained"];
+    }, {
+        readonly name: "folder";
+        readonly description: "the folder to move to, or to use; for contained: on, off or status";
+        readonly required: false;
+        readonly when: readonly ["move", "use", "contained"];
+    }];
+    readonly options: readonly [{
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        label?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        label?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
+    }];
+    readonly json: true;
+}, {
+    readonly name: "engine";
+    readonly summary: "(beta) what runs your sandbox (Windows Sandbox or HCS) and what each engine can do on this PC";
+    readonly group: "Health";
+    readonly examples: readonly ["sandbox engine                  the engine in use and what each can do", "sandbox engine check hcs        what this PC lacks for the HCS engine, and the commands that would fix it"];
+    readonly args: readonly [{
+        readonly name: "action";
+        readonly description: "show or check";
+        readonly required: false;
+        readonly choices: readonly ["show", "check"];
+    }, {
+        readonly name: "engine";
+        readonly description: "the engine to check";
+        readonly required: false;
+        readonly choices: readonly ["windows-sandbox", "hcs"];
+        readonly when: "check";
     }];
+    readonly options: readonly [];
     readonly json: true;
 }, {
     readonly name: "clean";
@@ -438,6 +490,20 @@ declare const COMMAND_LIST: readonly [{
         readonly value: "n";
         readonly description: "launch folders older than this many days";
         readonly default: 7;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        label?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }];
 }, {
     readonly name: "sync";
@@ -447,7 +513,7 @@ declare const COMMAND_LIST: readonly [{
     readonly options: readonly [];
 }, {
     readonly name: "audit";
-    readonly summary: "what happened in your sandboxes: programs started, files changed, sessions, repo guard (audit.enabled)";
+    readonly summary: "what happened in your sandboxes: programs started, files changed, sessions, repo guard (turn it on: sandbox config set audit.enabled true)";
     readonly group: "Health";
     readonly json: true;
     readonly args: readonly [];
@@ -469,6 +535,8 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }, {
         flag: string;
         type: "string" | "number" | "boolean" | "list";
@@ -481,6 +549,8 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }];
 }, {
     readonly name: "logs";
@@ -499,6 +569,22 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        label?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }];
 }, {
     readonly name: "setup";
@@ -508,7 +594,7 @@ declare const COMMAND_LIST: readonly [{
     readonly options: readonly [];
 }, {
     readonly name: "doctor";
-    readonly summary: "check this PC and show what will be copied or downloaded";
+    readonly summary: "check this PC, the install, your settings and the sandbox, and offer to fix what it finds";
     readonly group: "Health";
     readonly args: readonly [];
     readonly options: readonly [{
@@ -523,7 +609,24 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        label?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }];
+    readonly json: true;
 }, {
     readonly name: "migrate";
     readonly summary: "bring your saved settings up to date with this version";
@@ -541,6 +644,8 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }, {
         flag: string;
         type: "string" | "number" | "boolean" | "list";
@@ -553,6 +658,22 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        label?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }];
 }, {
     readonly name: "update";
@@ -571,6 +692,22 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        label?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }, {
         flag: string;
         type: "string" | "number" | "boolean" | "list";
@@ -583,6 +720,8 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }, {
         flag: string;
         type: "string" | "number" | "boolean" | "list";
@@ -595,6 +734,8 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }, {
         flag: string;
         type: "string" | "number" | "boolean" | "list";
@@ -607,6 +748,8 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }, {
         flag: string;
         type: "string" | "number" | "boolean" | "list";
@@ -619,17 +762,35 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }];
 }, {
     readonly name: "repair";
-    readonly summary: "find and fix common problems (stale state, broken downloads, half-installed tools)";
+    readonly summary: "find and fix problems (install, data folder, settings, stale state, half-installed tools)";
     readonly group: "Health";
     readonly args: readonly [];
-    readonly options: readonly [];
+    readonly options: readonly [{
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        label?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
+    }];
+    readonly json: true;
 }, {
     readonly name: "self-test";
     readonly summary: "run the built-in tests";
     readonly group: "Health";
+    readonly hidden: true;
     readonly args: readonly [{
         readonly name: "suite";
         readonly description: "run only these test suites, e.g. config live-daemon (default: all)";
@@ -640,12 +801,23 @@ declare const COMMAND_LIST: readonly [{
 }, {
     readonly name: "config";
     readonly summary: "show or create your settings file, or check a project's .sandbox-config.json";
-    readonly group: "Config";
+    readonly group: "Health";
     readonly args: readonly [{
         readonly name: "action";
         readonly description: "what to do";
         readonly required: false;
-        readonly choices: readonly ["show", "path", "init", "schema", "check"];
+        readonly choices: readonly ["show", "path", "init", "schema", "check", "get", "set", "export", "import"];
+        readonly aliases: readonly ["summary"];
+    }, {
+        readonly name: "key";
+        readonly description: "(get, set, reset) the setting, e.g. sandbox.memoryMb; (export, import) the .json file";
+        readonly required: false;
+        readonly when: readonly ["get", "set", "export", "import"];
+    }, {
+        readonly name: "value";
+        readonly description: "(set) the new value";
+        readonly required: false;
+        readonly when: "set";
     }];
     readonly options: readonly [{
         flag: string;
@@ -659,11 +831,42 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        label?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
+    }, {
+        flag: string;
+        type: "string" | "number" | "boolean" | "list";
+        description: string;
+        short?: string | undefined;
+        value?: string | undefined;
+        label?: string | undefined;
+        default?: string | number | undefined;
+        choices?: string[] | "harnesses" | "sessions" | "accounts" | undefined;
+        advanced?: boolean | undefined;
+        when?: string | undefined;
+        noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }];
+    readonly examples: readonly ["sandbox config set sandbox.memoryMb 8192", "sandbox config get sandbox.memoryMb", "sandbox config reset sandbox.memoryMb", "sandbox config list", "sandbox config export team-settings.json", "sandbox config import team-settings.json"];
 }, {
     readonly name: "agent-commands";
     readonly summary: "(Beta) make claude, codex ... on this PC start in a hidden sandbox and attach";
-    readonly group: "Agents";
+    readonly group: "Advanced";
     readonly args: readonly [{
         readonly name: "action";
         readonly description: "on, off or status";
@@ -671,9 +874,22 @@ declare const COMMAND_LIST: readonly [{
         readonly choices: readonly ["status", "on", "off"];
     }];
     readonly options: readonly [];
+}, {
+    readonly name: "vpn";
+    readonly summary: "the VPN for the sandbox: save your login, see whether it is on (NordVPN first)";
+    readonly group: "Advanced";
+    readonly args: readonly [{
+        readonly name: "action";
+        readonly description: "status, login or logout";
+        readonly required: false;
+        readonly choices: readonly ["status", "login", "logout"];
+    }];
+    readonly options: readonly [];
+    readonly json: true;
+    readonly examples: readonly ["sandbox vpn login", "sandbox vpn status"];
 }, {
     readonly name: "host-claude";
-    readonly summary: "run Claude on this PC, NOT sandboxed, with its own profile";
+    readonly summary: "run Claude on this PC, NOT sandboxed, with its own profile (same as: sandbox host claude)";
     readonly group: "Agents";
     readonly args: readonly [];
     readonly options: readonly [{
@@ -688,9 +904,12 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }];
     readonly passthrough: "agent";
     readonly interactive: true;
+    readonly hidden: true;
 }, {
     readonly name: "host";
     readonly summary: "run an agent on this PC, NOT sandboxed (sandbox host <agent> -- <arguments>)";
@@ -713,17 +932,32 @@ declare const COMMAND_LIST: readonly [{
         advanced?: boolean | undefined;
         when?: string | undefined;
         noMenu?: boolean | undefined;
+        group?: string | undefined;
+        shownAs?: string | undefined;
     }];
     readonly passthrough: "agent";
     readonly interactive: true;
 }, {
     readonly name: "menu";
     readonly summary: "the interactive menu (what `sandbox` opens with no arguments)";
-    readonly group: "Config";
+    readonly group: "Advanced";
     readonly args: readonly [];
     readonly options: readonly [];
     readonly hidden: true;
     readonly interactive: true;
+}, {
+    readonly name: "web";
+    readonly summary: "(beta) your sandbox sessions in a browser on this PC: start, stop, status or open";
+    readonly group: "Web";
+    readonly examples: readonly ["sandbox web open               start the web UI and open it in your browser"];
+    readonly args: readonly [{
+        readonly name: "action";
+        readonly description: "start the server, stop it, show whether it runs, or open it in your browser";
+        readonly required: false;
+        readonly choices: readonly ["start", "stop", "status", "open"];
+    }];
+    readonly options: readonly [];
+    readonly json: true;
 }, {
     readonly name: "_watch";
     readonly summary: "background history sync";
@@ -731,7 +965,15 @@ declare const COMMAND_LIST: readonly [{
     readonly args: readonly [];
     readonly options: readonly [];
     readonly hidden: true;
+}, {
+    readonly name: "_web";
+    readonly summary: "the web UI server (started by sandbox web start)";
+    readonly group: "Web";
+    readonly args: readonly [];
+    readonly options: readonly [];
+    readonly hidden: true;
 }];
+/** The hand-written commands (the shared core's own commands are not in this union). */
 export type CommandName = (typeof COMMAND_LIST)[number]['name'];
 export declare const COMMANDS: CommandSpec[];
 export declare function commandSpec(name: string): CommandSpec | undefined;