bdy sandbox

Start a stopped sandbox Required scopes: SANDBOX_WRITE

Stop a running sandbox Required scopes: SANDBOX_WRITE

Manage long-running apps in a sandbox

Copy files and directories between the local machine and a sandbox (downloading needs only SANDBOX_READ, uploading SANDBOX_WRITE) Required scopes: SANDBOX_READ, SANDBOX_WRITE

Create a new sandbox. Pre-installed tools: node 24, docker 29, go 1.25, python 3, git, curl, wget, jq, rsync, ripgrep, unzip, nano, bdy Required scopes: SANDBOX_WRITE

Delete a sandbox Required scopes: SANDBOX_MANAGE

Manage public endpoints that expose sandbox ports

Run commands in a sandbox and manage them

Show sandbox details Required scopes: SANDBOX_READ

List sandboxes Required scopes: SANDBOX_READ

Show the sandbox setup log: stdout/stderr and exit codes from boot commands (--boot-command) and from each fetch source (--fetch, including the optional build= step) Does NOT include: - application output → use "bdy sb app logs <sandbox-identifier> <app-id>" - exec output → use "bdy sb exec logs <sandbox-identifier> <command-id>" Required scopes: SANDBOX_READ

Open this resource in a browser Required scopes: SANDBOX_READ

Restart a sandbox Required scopes: SANDBOX_WRITE

Manage sandbox snapshots

Open an interactive SSH session to a sandbox Authenticates with the SSH key you added to your Buddy account - the session always runs as the buddy user, whatever login is sent Arguments for ssh itself, or a command to run instead of a shell, go after -- Required scopes: SANDBOX_READ

Show sandbox status Required scopes: SANDBOX_READ

Update a sandbox from a YAML definition Required scopes: SANDBOX_WRITE

Print a sandbox definition as YAML Required scopes: SANDBOX_READ