mirror of
https://github.com/docker/docs.git
synced 2026-11-04 10:01:00 +00:00
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.
42 lines
1.6 KiB
YAML
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.
|