Commit Graph
33 Commits
Author SHA1 Message Date
David Karlsson c572cdcb54 docs: cover sbx 0.50 user-facing changes (#26449)
Documents six user-facing changes in sbx 0.50: kit host mount bindings,
persistent kit volume retention, environment MCP command approvals and
ownership, HTTP query restrictions, cloud sandbox inspection, and exec
exit status in automation. Each change has its own commit. Also vendors
the matching v0.50 CLI reference verbatim and regenerates the release
notes from published GitHub releases.

Kit documentation focuses on sbx usage and links to the canonical
capability definitions. Volume retention follows the 0.50
implementation; the upstream spec's main branch describes a different
storage lifecycle.

Verified against the release implementation. Scoped Markdown and prose
lint, a full Hugo build, and checks of the added internal links pass.

Related release: https://github.com/docker/sandboxes/issues/7698

Generated by Codex
2026-10-26 17:28:15 +01:00
David Karlsson a1e520f672 docs: vendor Sandboxes v0.49 CLI reference
Copy docs/yml/*.yaml from docker/sandboxes release/v0.49 at c5b19951af121b439800029695f88bf1139a0b0b into data/sbx_cli without local edits.
2026-10-21 11:09:53 +00:00
David Karlsson c64e3927ef docs: update Sandboxes for the v0.48.0 CLI refactor (#26314)
## Summary

Update the Sandbox documentation for the v0.48.0 CLI refactor: renamed
flags, settings commands, terminal output, structured output, and
non-interactive confirmations. Add a migration reference for scripts and
CI workflows, with a [**Copy as prompt**
button](https://deploy-preview-26314--docsdocker.netlify.app/ai/sandboxes/workflows/automation/#update-scripts-for-v0480)
that copies agent instructions and the section Markdown.

This PR targets `main` independently of the other PRs in the sbx/v0.48.0
milestone. It keeps the generated reference import separate from
documentation edits:

- Vendor the 120 generated CLI YAML files
- Update command examples and guidance. Historical release notes retain
their original command spellings.

The other milestone PRs cover separate release features; this PR covers
the CLI migration.

@netlify /ai/sandboxes/workflows/automation/

Generated by Codex
2026-10-13 17:18:50 +02:00
David KarlssonandClaude Opus 5.5 c5ab24b0de sbx: vendor v0.47.0 cli reference
Copied from docker/sandboxes docs/yml at release/v0.47
(0411f50ee470, v0.47.0-rc2).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-05 09:32:22 +02:00
David Karlsson 1ebffcd508 sbx: vendor v0.46.0 cli reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-09-29 00:23:52 +02:00
David Karlsson 3de2f99327 docs: cloud sandboxes CLI (#26158)
## Description

Add cloud Sandboxes documentation for sbx v0.45.0, covering credentials,
network policy, lifecycle, environment files, and transfers between
local and cloud sandboxes. Document named sandbox reuse and resume,
resource sizes and platform selection, custom secrets, move behavior,
and local UDP guidance.

Link to the canonical Docker Agentic Platform signup, billing, and
Console MCP instructions. Keep CLI sign-in, access checks, and cloud
credential setup in the Sandboxes guides.

This PR also vendors the CLI reference including `sbx move`, and aligns
timeout and move guidance with it. Kits v3 and API/SDK documentation are
handled separately.

Validation: scoped Markdown and Vale checks and a full Hugo build
passed. Cloud and Agentic Platform guides passed rendered internal link
and anchor checks, including the canonical signup page's discovery. The
earlier CLI import verified all 119 vendored files against upstream
byte-for-byte and checked 1,083 rendered CLI-reference links and
anchors. Behavior was checked against source; live cloud workflows and
checkout were not exercised.

@netlify /ai/sandboxes/cloud/

Generated by Codex
2026-09-24 18:13:01 +02:00
David Karlsson 3bba652927 sbx: vendor sbx v0.45.0 cli reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-09-22 15:27:05 +02:00
David Karlsson a31474799c sbx: vendor v0.43.0 cli reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-09-15 13:43:19 +02:00
David KarlssonandCodex 91ba153bb5 docs: vendor sbx v0.42.0 CLI reference
The checked-in sbx command reference predates the v0.42.0 release and omits or misstates its command surface.

Replace data/sbx_cli with the generated v0.42.0 reference while preserving the corrected private-network example from PR #26004.

Co-Authored-By: Codex <noreply@openai.com>
2026-09-07 10:25:55 +00:00
Craig Osterhout c596433b17 sbx: update example (#26004)
<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

https://docker.slack.com/archives/C04300R4G5U/p1788368732779929

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-09-02 10:35:17 -07:00
David Karlsson aa76a6e1ee chore: vendor sbx v0.39.0 cli reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-08-20 10:51:09 +02:00
David Karlsson 0eeb98a879 Merge pull request #25487 from dvdksn/worktree-sbx-env-docs
docs(sandboxes): add sandbox environments section (sbx env, experimental)
2026-08-19 12:58:00 +02:00
David Karlsson fda58d98bd sbx: vendor v0.38.0 cli reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-08-06 15:13:37 +02:00
Craig Osterhout 27e3346a3a sbx: sync cli ref for 0.35.0 (#25532)
<!--Delete sections as needed -->

## Description

Syncs all CLI reference YAML files in `data/sbx_cli/` from
`docker/sandboxes` at the v0.35.0 tag.

### New commands

| Command | Notes |
|---------|-------|
| `sbx daemon start/stop/status/log-level` | Manage the sandbox daemon
directly |
| `sbx policy check network` | Test whether the current policy would
allow a request |
| `sbx policy inspect` | Inspect a single policy or rule (replaces `sbx
policy show`) |
| `sbx secret import` | Import credential env vars into the keychain |

### Updated commands

| Command | What changed |
|---------|--------------|
| `sbx rm` | New `--force` flag for active sessions |
| `sbx policy ls` | New `--wide`, `--source`, `--decision` filters;
updated output format |
| `sbx policy` | Updated `see_also` to list new subcommands |
| `sbx secret` | Updated `see_also` to list `import` subcommand |
| `sbx kit add` | Synopsis and description reflect swap-recreate
behavior |

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-07-10 10:44:45 -07:00
David Karlsson d8666ddbaf sbx: vendor v0.34.0 cli reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-06-29 16:17:45 +02:00
David Karlsson d20aca1414 docs(sandboxes): vendor v0.33 cli reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-06-17 09:51:04 +02:00
David KarlssonandClaude Opus 4.8 e92bd0bfb4 sbx: vendor v0.32.0 CLI reference
Update the vendored sbx CLI reference data for v0.32.0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-05 14:36:24 +02:00
David Karlsson 888b4d19ff sbx: vendor v0.31.0 cli reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-05-28 22:10:19 +02:00
David KarlssonandClaude Sonnet 4.6 e613d0ffc9 Update sbx CLI reference data
Add sbx kit subcommand references and update policy/login/ports/rm/secret
command descriptions and option documentation.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-19 17:05:54 +02:00
David KarlssonandCodex f01a8cbe9c docs: document sandbox-scoped kit network policies
Kit network policy docs did not cover sandbox-scoped rules or kit-level deniedDomains.

Update the Sandboxes policy and kits pages with scoped policy examples, deniedDomains guidance, and a small policy page formatting fix.

Co-Authored-By: Codex <noreply@openai.com>
2026-05-13 08:17:20 +02:00
David Karlsson 8fe145920f sbx: add cursor cli reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-04-30 17:51:16 +02:00
David Karlsson c51cb3852e Merge pull request #24870 from dvdksn/kits
sbx: kits
2026-04-29 06:55:00 +02:00
David Karlsson 3b55a073d8 Merge pull request #24910 from dvdksn/sbx/cp
Document sbx cp
2026-04-28 19:16:48 +02:00
David Karlsson ccf02699cc sbx: kits
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-04-28 18:31:14 +02:00
David Karlsson e6a16bf843 chore: add network policy ls before rm to get id
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-04-28 10:12:01 +02:00
David Karlsson 1cda2e3849 docs: add sbx cp reference 2026-04-27 19:32:42 +02:00
David Karlsson 4da24a0a46 sbx: sbx template rm [id]
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-04-21 16:33:39 +02:00
David Karlsson f2eccfe389 sbx: add droid agent
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-04-20 17:28:32 +02:00
David KarlssonandClaude Opus 4.7 b266800a93 sbx: add diagnose command (#24758)
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>

---------

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-17 10:21:42 +01:00
David Karlsson c953aeeb6a Merge pull request #24734 from dvdksn/fix/sbx-save-load-docs
docs: add sbx save/load snapshot workflow to custom environments
2026-04-17 10:51:04 +02:00
David Karlsson 1e2da073ea sbx: bump cli reference v0.25
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-04-14 12:52:35 +02:00
David KarlssonandClaude Sonnet 4.6 1947a34490 Document --oauth flag for sbx secret set openai
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-09 11:27:33 +02:00
David Karlsson cdde205ba8 sandboxes: add sbx documentation
Add full documentation for the sbx CLI sandbox experience including
get-started, usage guide, architecture, agents (claude-code, codex,
copilot, gemini, kiro, opencode, cagent, custom-environments),
security (isolation, credentials, policy, workspace trust),
troubleshooting, and FAQ. Update _index.md as the section landing
page.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-03-31 17:35:01 +02:00