Skip to content

sbx: clarify sandbox auto-naming in docs#25074

Merged
dvdksn merged 2 commits into
docker:mainfrom
Pradumnasaraf:sbx/document-auto-naming
May 20, 2026
Merged

sbx: clarify sandbox auto-naming in docs#25074
dvdksn merged 2 commits into
docker:mainfrom
Pradumnasaraf:sbx/document-auto-naming

Conversation

@Pradumnasaraf

@Pradumnasaraf Pradumnasaraf commented May 16, 2026

Copy link
Copy Markdown
Contributor

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.

Screenshot 2026-05-16 at 2 48 30 PM

Reviews

  • Technical review
  • Editorial review
  • Product review

Document the <agent>-<directory> auto-naming rule and use concrete
names that match it in examples. Where --name is shown, keep a
custom-looking value so the flag's purpose is visible.
@Pradumnasaraf Pradumnasaraf requested a review from dvdksn as a code owner May 16, 2026 09:38
@netlify

netlify Bot commented May 16, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 42d4a49
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a0daa0ceffbec00080accc4
😎 Deploy Preview https://deploy-preview-25074--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@shivaylamba shivaylamba left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Amazing PR - makes a lot of sense and makes it super simple to understand!

Revert changes to usage.md and other sandbox docs; keep only the
get-started.md naming clarification.

@dvdksn dvdksn left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you @Pradumnasaraf

@dvdksn dvdksn merged commit f0752e1 into docker:main May 20, 2026
14 checks passed
dvdksn pushed a commit to dvdksn/docs that referenced this pull request May 29, 2026
## 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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants