bdy crawl link

$bdy crawl link [options]

Link current directory to a crawl suite Required scopes: CRAWL_WRITE

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 <workspace>

Workspace URL handle. Can be set via variable: BUDDY_WORKSPACE

-p, --project <project>

Project name. Can be set via variable: BUDDY_PROJECT

-s, --suite <suite>

Suite identifier

--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.20

Last modified on Oct 14, 2026

Examples

Interactively link current directory to a crawl suite
bdy crawl link$

Link non-interactively to a specific suite
bdy crawl link -w workspace -p project -s suite-identifier$