bdy sandbox app add

$bdy sandbox app add [options] <identifier> <app-command>

Add an app to a sandbox Required scopes: SANDBOX_WRITE

ARGUMENTS

identifier

Sandbox identifier (required)

app-command

Application command to run at startup (can be used multiple times) (required)

OPTIONS

--context <name>

Connection and scope context: default, git, link or a saved name. Overrides the globally active context for this invocation.

--examples

Show only examples; with this flag --format accepts text, json or jsonl

--verbose

Show REST API requests, responses, timing and retries on stderr

-w, --workspace <domain>

Workspace URL handle. Can be set via variable: BUDDY_WORKSPACE

-p, --project <name>

Project name. Can be set via variable: BUDDY_PROJECT

--scope <scope>

Force scope (WORKSPACE, PROJECT, ENVIRONMENT). By default calculated by provided options and environmental variables (--project,

--environment

BUDDY_PROJECT, linked project)

-e, --environment <identifier>

Environment identifier

--app-identifier <identifier>

App identifier. Generated from the command when not set

--path <directory>

Directory the app is run in. Defaults to the sandbox app directory

--format <text|json>

Output format: json, text. JSON CLI errors: {error:{code,message,hint}}, exit 1. Default: text (choices: "text", "json")

-h, --help

display help for command

Documentation for bdy v1.25.34

Last modified on Nov 3, 2026

Examples

Add sandbox app

bdy sb app add sandbox-identifier "npm start"$

Add sandbox app with its own identifier and directory

bdy sb app add sandbox-identifier "npm start" --app-identifier web --path /home/buddy/web$

Return the result as JSON

bdy sandbox app add my-sandbox "sleep 3600" --format json$