Skip to content

Commit f0752e1

Browse files
sbx: clarify sandbox auto-naming in docs (#25074)
## Description Running `sbx run claude` from `~/my-pro` produces a sandbox named `claude-my-pro`, but the docs tell you to clean up with `sbx rm my-sandbox` and never explain where that name came from. This PR documents the `<agent>-<directory>` and updates examples across the sandbox docs to use names that match the rule, so the flow lines up with what users actually see in `sbx ls`. <img width="1391" height="703" alt="Screenshot 2026-05-16 at 2 48 30 PM" src="https://github.com/user-attachments/assets/b0357bb5-32ea-48f4-ab5d-8494431e2772" /> ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [x] Technical review - [ ] Editorial review - [ ] Product review
1 parent 70fca02 commit f0752e1

1 file changed

Lines changed: 7 additions & 3 deletions

File tree

content/manuals/ai/sandboxes/get-started.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -199,7 +199,7 @@ directory without touching your main working tree.
199199
When the session ends, review what the agent did from the worktree:
200200

201201
```console
202-
$ cd .sbx/<sandbox-name>-worktrees/my-feature
202+
$ cd .sbx/claude-my-project-worktrees/my-feature
203203
$ git log
204204
$ git diff main
205205
```
@@ -243,15 +243,19 @@ set and how to customize it.
243243
Sandboxes persist after the agent exits. To stop a sandbox without deleting it:
244244

245245
```console
246-
$ sbx stop my-sandbox
246+
$ sbx stop claude-my-project
247247
```
248248

249+
The sandbox name comes from the agent and workspace directory — see
250+
[Reconnecting and naming](usage.md#reconnecting-and-naming) for details, or run
251+
`sbx ls` to see the names of your existing sandboxes.
252+
249253
Installed packages, Docker images, and configuration changes are preserved
250254
across restarts. When you're done with a sandbox, remove it to reclaim disk
251255
space:
252256

253257
```console
254-
$ sbx rm my-sandbox
258+
$ sbx rm claude-my-project
255259
```
256260

257261
Removing a sandbox deletes everything inside it — installed packages, Docker

0 commit comments

Comments
 (0)