Get Started on Cloud
BasicsAI AgentsPipelinesActions & ServicesEnvironmentsIntegrationsTargetsTestsDomainsSandboxesTerraformTunnelsYAMLBuddy GitCLIAPIFAQ

bdy tests visual session

View as Markdown
$bdy tests visual session [options] [command]

Manage visual test sessions

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
Close a parallel visual test session early (skip auto-close timeout)
Run a test command and create a visual test session from emitted snapshots

Documentation for bdy v1.25.34

Last modified on Nov 3, 2026

Next pageGetting Started

Examples

Run your test command with the visual-test plugin server attached
bdy tests visual session create "npm test"$
Skip resource discovery (debugging or asset-free pages)
bdy tests visual session create "npm test" --skipDiscovery$
Send snapshots progressively (quicker review during long runs)
bdy tests visual session create "npm test" --oneByOne$
One runner in a parallel session (every runner must share the same $SNAPSHOTS_BUILD_ID)
bdy tests visual session create "npm test" --parallel$
Close the session after all parallel runners finished (build id read from $SNAPSHOTS_BUILD_ID)
bdy tests visual session close$