variable: promote variables out of sandbox into a top-level command

README.md

@@ -89,9 +89,9 @@ agent asset list                  # list stored assets (--session <id> scopes to
 agent asset get <asset-id> -o shot.png   # show one asset, or download its bytes with -o
 agent asset delete <asset-id>     # delete an asset (it disappears from list/get and its link stops resolving)
 
-agent sandbox variable list       # list sandbox env variable names (values are write-only)
-agent sandbox variable set A=1 B=2     # create/update variables (or --from-file .env/.json)
-agent sandbox variable delete K   # delete a variable
+agent variable list               # list sandbox env variable names (values are write-only)
+agent variable set A=1 B=2        # create/update variables (or --from-file .env/.json)
+agent variable delete K           # delete a variable
 
 agent budget                      # current budget summary
 agent usage                       # usage dashboard for the period

skills/ellipsis/SKILL.md

@@ -78,8 +78,8 @@ sandbox image actually builds, then deploy. The steps below are that flow.
    write-only store; a config receives only the variables it names.
 
    ```sh
-   agent sandbox variable set LINEAR_API_KEY=lin_api_...
-   agent sandbox variable set --from-file .env
+   agent variable set LINEAR_API_KEY=lin_api_...
+   agent variable set --from-file .env
    ```
 
 5. Draft a config and run it from the local file before anything deploys.
@@ -208,7 +208,7 @@ agent config default set <config-id>         # the config a bare start runs (--r
 agent template list                          # browse maintained templates
 agent model list                             # the model ids valid under `claude:`
 agent integration                            # connected GitHub/Slack/Linear/Sentry
-agent sandbox variable set LINEAR_API_KEY=...
+agent variable set LINEAR_API_KEY=...
 agent session start --config-file agents/my_agent.yaml --watch
                                              # prove a config before deploying
 ```

src/cli.tsx

@@ -5,7 +5,7 @@ import { registerMe } from './commands/me'
 import { registerSession } from './commands/session'
 import { registerReview } from './commands/review'
 import { registerConfig } from './commands/config'
-import { registerSandbox } from './commands/sandbox'
+import { registerVariable } from './commands/variable'
 import { registerAsset } from './commands/asset'
 import { registerHook } from './commands/hooks'
 import { registerTemplate } from './commands/template'
@@ -39,7 +39,7 @@ registerMe(program)
 registerSession(program)
 registerReview(program)
 registerConfig(program)
-registerSandbox(program)
+registerVariable(program)
 registerAsset(program)
 registerHook(program)
 registerTemplate(program)

src/commands/sandbox.ts → src/commands/variable.ts

@@ -5,13 +5,9 @@ import { alsoKnownAs, apiRoutes } from '../lib/help'
 import { formatTs, printJson, printTable, runAction } from '../lib/output'
 import type { SandboxVariableInput, SandboxVariableSummary } from '../lib/types'
 
-export function registerSandbox(program: Command): void {
-  const sandbox = program
-    .command('sandbox')
-    .description('Manage what every sandbox this account runs gets')
-
+export function registerVariable(program: Command): void {
   const variable = alsoKnownAs(
-    sandbox
+    program
       .command('variable')
       .description('Manage the env variables injected into every sandbox (values are write-only)'),
     'variables',

src/lib/help.ts

@@ -20,7 +20,7 @@ function withoutAliases(term: string, cmd: Command): string {
 const TOP_LEVEL_GROUPS: ReadonlyArray<{ title: string; commands: readonly string[] }> = [
   { title: 'Sessions', commands: ['session', 'review'] },
   { title: 'Agents', commands: ['config', 'model', 'template'] },
-  { title: 'Platform', commands: ['sandbox', 'asset', 'hook'] },
+  { title: 'Platform', commands: ['variable', 'asset', 'hook'] },
   { title: 'Integrations', commands: ['integration', 'github', 'slack', 'linear', 'sentry'] },
   { title: 'Spend', commands: ['budget', 'usage', 'analytics'] },
   { title: 'Account', commands: ['login', 'logout', 'me', 'host', 'ping'] },

test/sandbox.test.ts → test/variable.test.ts

@@ -4,7 +4,7 @@ import {
   parseAssignment,
   parseEnvFile,
   parseJsonVars,
-} from '../src/commands/sandbox'
+} from '../src/commands/variable'
 
 describe('parseJsonVars', () => {
   it('parses a flat object of name → value', () => {