Files
docker-docs/data/sbx_cli/sbx_attach.yaml
T
David Karlsson 1773367159 Sync sbx CLI reference from release/v0.51 (#26514)
Vendor the checked-in CLI YAML from Docker Sandboxes release/v0.51 at
7d55286de0c7. This updates command help, adds `sbx policy check http`,
and replaces seven agent-specific create pages with redirects to `sbx
create`.

Validation: full site build with Hugo 0.169.0; upstream byte-for-byte
comparison; all 115 command pages, reference links, and seven redirects
checked; template formatting and whitespace checks passed.
2026-11-04 10:10:52 +01:00

42 lines
1.6 KiB
YAML

name: sbx attach
synopsis: |
Attach to a cloud sandbox, starting it first if it is stopped
description: |-
Attach an interactive terminal session to a cloud sandbox.
SANDBOX is the cloud sandbox ID (sbx_*) or name from "sbx --cloud ls".
Opens a PTY-backed exec session against the sandbox's agent process. The
sandbox must already exist; a stopped one is started first. Use
`sbx --cloud run` to create a sandbox and attach in one step.
Only supported with --cloud. See https://docs.docker.com/ai/sandboxes/ for the cloud sandbox model.
usage: sbx attach SANDBOX [flags]
options:
- name: detach-keys
usage: |
Override the detach gesture that leaves the session running (Docker-style, e.g. "ctrl-\", "ctrl-x,ctrl-d"). Default: Ctrl-\. Use this when the default collides with an agent's keymap (cloud only).
- name: help
shorthand: h
default_value: "false"
usage: help for attach
inherited_options:
- name: cloud
default_value: "false"
usage: |
Dispatch to Docker Cloud Sandboxes API instead of local sandboxd (supported by a growing set of verbs — run 'sbx --cloud --help' for the current list)
- name: debug
shorthand: D
default_value: "false"
usage: Enable debug logging
- name: no-input
default_value: "false"
usage: |
Never prompt; commands that need an answer fail with the command to run instead
example: |4-
# Attach to a sandbox by ID or name
sbx --cloud attach sbx_abc123
sbx --cloud attach claude/my-sandbox
see_also:
- sbx - Manage AI coding agent sandboxes.