For AI agents: the complete documentation index is at https://buddy.works/llms.txt
$bdy artifact download|dd [options] <identifier> <directory>
Download a version of a file artifact Required scopes: ARTIFACT_READ
ARGUMENTSidentifier
Human-readable ID of the artifact and optionally version: artifact:version or artifact@version (optional)directory
Path to the directory where version will be downloaded (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--scope <scope>
Force scope (WORKSPACE, PROJECT). By default calculated by provided options and environmental variables (--project, BUDDY_PROJECT, linked project)-p, --project <name>
Project name. Can be set via variable: BUDDY_PROJECT-m, --merge
Merge contents of the directory with artifact-r, --replace
Replace contents of the directory with artifact--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
Download file artifact version to local directory bdy art dd artifact-identifier:version /path/to/dir$
Download latest file artifact version and replace contents of existing local directory bdy art dd artifact-identifier /path/to/dir --replace$
Download file artifact version and merge it with existing local directory bdy art dd artifact-identifier:version /path/to/dir --merge$