bdy tests visual session create

$bdy tests visual session create [options] <command>

Run a test command and create a visual test session from emitted snapshots

ARGUMENTS

command

Test runner command (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

--skipDiscovery

Skip post-snapshot resource discovery (debugging or asset-free pages)

--oneByOne

Send snapshots progressively for early review during long runs

--parallel

Run as part of a parallel session (multi-machine/process)

-h, --help

display help for command

Documentation for bdy v1.25.20

Last modified on Oct 14, 2026

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$