From ceed5f5053b127a1351df60080c7dcfc9e6e3423 Mon Sep 17 00:00:00 2001 From: Elisabeth Rulke Date: Thu, 8 Oct 2026 12:28:04 -0700 Subject: [PATCH 1/3] [sandbox-skill] Document coding agent shortcuts --- skills/sandbox/SKILL.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/skills/sandbox/SKILL.md b/skills/sandbox/SKILL.md index 85ce5312..a9db583e 100644 --- a/skills/sandbox/SKILL.md +++ b/skills/sandbox/SKILL.md @@ -987,6 +987,12 @@ sandbox create --region # Defaults to iad1; any Vercel regi sandbox create --failover-regions , # Comma-separated sandbox create --failover-regions none # No failover, overrides the project default +# Start a coding agent (interactive terminal required) +sandbox create opencode +sandbox create pi +sandbox create claude +sandbox create codex + # Fork an existing sandbox (inherits config, incl. env; --env replaces it) sandbox fork sandbox fork --name my-fork --vcpus 4 --env FOO=1 @@ -1047,6 +1053,13 @@ sandbox config network-policy --network-policy deny-all sandbox config tags --tag env=prod ``` +Agent shortcuts use the universal image and require an interactive terminal. +Do not combine them with `--image`, `--runtime`, or `--snapshot`. Configure +authentication for the agent separately from `sandbox login`. + +Exiting the agent leaves the sandbox running. Use the printed reconnect or stop +command and follow any environment-variable reminder printed with it. + ## Common Patterns ### Dev Server Pattern (Persistent) From b3be0acac8effbd9f97f72512e7416a51baaa171 Mon Sep 17 00:00:00 2001 From: Elisabeth Rulke Date: Thu, 8 Oct 2026 12:39:10 -0700 Subject: [PATCH 2/3] [sandbox-skill] Clarify silent agent output --- skills/sandbox/SKILL.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/skills/sandbox/SKILL.md b/skills/sandbox/SKILL.md index a9db583e..4f0c27b5 100644 --- a/skills/sandbox/SKILL.md +++ b/skills/sandbox/SKILL.md @@ -1057,8 +1057,9 @@ Agent shortcuts use the universal image and require an interactive terminal. Do not combine them with `--image`, `--runtime`, or `--snapshot`. Configure authentication for the agent separately from `sandbox login`. -Exiting the agent leaves the sandbox running. Use the printed reconnect or stop -command and follow any environment-variable reminder printed with it. +Exiting the agent leaves the sandbox running. Unless you pass `--silent`, the CLI +prints reconnect and stop commands. Follow any environment-variable reminder +printed with the reconnect command. ## Common Patterns From 20f3087b50c1e3b42a7890cc91bdeb0f2c5f4fc0 Mon Sep 17 00:00:00 2001 From: Elisabeth Rulke Date: Fri, 9 Oct 2026 10:04:12 -0700 Subject: [PATCH 3/3] [sandbox-cli] Show an agent example first in help --- .changeset/agent-help-example.md | 5 +++++ packages/sandbox/docs/index.md | 4 ++++ packages/sandbox/src/app.ts | 4 ++++ 3 files changed, 13 insertions(+) create mode 100644 .changeset/agent-help-example.md diff --git a/.changeset/agent-help-example.md b/.changeset/agent-help-example.md new file mode 100644 index 00000000..0e40d315 --- /dev/null +++ b/.changeset/agent-help-example.md @@ -0,0 +1,5 @@ +--- +"sandbox": patch +--- + +Show a coding agent launch example first in the top-level CLI help. diff --git a/packages/sandbox/docs/index.md b/packages/sandbox/docs/index.md index a4ec0057..f6d3f511 100644 --- a/packages/sandbox/docs/index.md +++ b/packages/sandbox/docs/index.md @@ -30,6 +30,10 @@ Commands: Examples: +– Start a coding agent in a sandbox + + $ sandbox create opencode + – Create a sandbox on a Secure Compute network (requires an Enterprise plan) $ sandbox create --network-id your_network_id_here diff --git a/packages/sandbox/src/app.ts b/packages/sandbox/src/app.ts index d0b7953c..e0d02b5e 100644 --- a/packages/sandbox/src/app.ts +++ b/packages/sandbox/src/app.ts @@ -48,6 +48,10 @@ export const app = (opts?: { withoutAuth?: boolean; appName?: string }) => { }), }, examples: [ + { + description: "Start a coding agent in a sandbox", + command: `${appName} create opencode`, + }, { description: "Create a sandbox on a Secure Compute network (requires an Enterprise plan)",