Get Started on Cloud
BasicsAI AgentsPipelinesActions & ServicesEnvironmentsIntegrationsTargetsTestsDomainsSandboxesTerraformTunnelsYAMLBuddy GitCLIAPIFAQ

bdy sandbox fetch

View as Markdown
$bdy sandbox fetch|f [options] [command]

Manage sources (repositories and artifacts) fetched into a sandbox

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
-h, --help
display help for command
AVAILABLE COMMANDS
Add a source to fetch into a sandbox: the project repository (default), a public repository (--repository) or an artifact (--artifact) Required scopes: SANDBOX_WRITE
Remove a source from a sandbox. Files already fetched into the sandbox are left in place Required scopes: SANDBOX_WRITE
Show fetch details Required scopes: SANDBOX_READ
List sources fetched into a sandbox with their revision and how far behind they are Required scopes: SANDBOX_READ
Fetch a source again Required scopes: SANDBOX_WRITE

Documentation for bdy v1.25.34

Last modified on Nov 3, 2026

Next pageGetting Started

Examples

List sources fetched into a sandbox
bdy sb fetch ls sandbox-identifier$
Return the result as JSON
bdy sandbox fetch list my-sandbox --format json$
Get fetch by its target directory
bdy sb fetch get sandbox-identifier /home/buddy/plugin$
Get the fetch into the app directory
bdy sb fetch get sandbox-identifier :default$
Fetch a branch of the project repository into the app directory
bdy sb fetch add sandbox-identifier --ref main$
Fetch a public repository and build it
bdy sb fetch add sandbox-identifier --repository https://github.com/buddy/plugin --path /home/buddy/plugin --build "npm ci"$
Fetch one file of an artifact
bdy sb fetch add sandbox-identifier --artifact my-artifact:latest --source-path dist.zip --path /home/buddy/dist$
Remove a fetch and automatically confirm
bdy sb fetch rm sandbox-identifier /home/buddy/plugin -f$
Fetch a source again
bdy sb fetch refetch sandbox-identifier /home/buddy/plugin$