bl record

Record browser sessions (screenshots and snapshots)

Usage

bl record [OPTIONS]
bl record <command>

Options

Option	Description
`--json`	Output as JSON
`--session <value>`	Run this command in the named session (env: BL_SESSION; default: "default")

Global options

Option	Description
`-v, --verbose`	Enable debug logging

`bl record start`

Start a recording

Usage

bl record start [OPTIONS]

Options

Option	Description
`--screenshots <value>`	Capture screenshots after each action (default true)
`--snapshots`	Capture HTML snapshots
`--sources`	Include source information
`--bidi`	Record raw BiDi commands in the recording
`--name <value>`	Name for the recording
`--title <value>`	Title shown in trace viewer (defaults to name)
`--format <value>`	Screenshot format: jpeg or png (default jpeg)
`--quality <value>`	JPEG quality 0.0-1.0 (ignored for png) (default 0.5)
`--json`	Output as JSON
`--session <value>`	Run this command in the named session (env: BL_SESSION; default: "default")

Global options

Option	Description
`-v, --verbose`	Enable debug logging

Examples

bl record start
# Start recording with screenshots (default)

bl record start --screenshots=false
# Record without screenshots

bl record start --snapshots
# Record with screenshots and HTML snapshots

bl record start --format png
# Use PNG format instead of JPEG (larger files, lossless)

bl record start --quality 0.1
# Lower JPEG quality for smaller recording files

bl record start --title "Login Flow"
# Set a title shown in the trace viewer

`bl record stop`

Stop recording and save

Usage

bl record stop [OPTIONS]

Options

Option	Description
`-o, --output <value>`	Output file path (default: record.zip)
`--json`	Output as JSON
`--session <value>`	Run this command in the named session (env: BL_SESSION; default: "default")

Global options

Option	Description
`-v, --verbose`	Enable debug logging

Examples

bl record stop
# Save recording to record.zip

bl record stop -o my-recording.zip
# Save recording to custom path

`bl record group`

Manage recording groups

Usage

bl record group [OPTIONS]
bl record group <command>

Options

Option	Description
`--json`	Output as JSON
`--session <value>`	Run this command in the named session (env: BL_SESSION; default: "default")

Global options

Option	Description
`-v, --verbose`	Enable debug logging

`bl record group start`

Start a named group in the recording

Usage

bl record group start <name> [OPTIONS]

Arguments

Argument	Description
`<name>`	Name for the group

Options

Option	Description
`--json`	Output as JSON
`--session <value>`	Run this command in the named session (env: BL_SESSION; default: "default")

Global options

Option	Description
`-v, --verbose`	Enable debug logging

Examples

bl record group start "Login"
# Groups nest actions in the trace viewer

`bl record group stop`

End the current recording group

Usage

bl record group stop [OPTIONS]

Options

Option	Description
`--json`	Output as JSON
`--session <value>`	Run this command in the named session (env: BL_SESSION; default: "default")

Global options

Option	Description
`-v, --verbose`	Enable debug logging

Examples

bl record group stop

`bl record chunk`

Manage recording chunks

Usage

bl record chunk [OPTIONS]
bl record chunk <command>

Options

Option	Description
`--json`	Output as JSON
`--session <value>`	Run this command in the named session (env: BL_SESSION; default: "default")

Global options

Option	Description
`-v, --verbose`	Enable debug logging

`bl record chunk start`

Start a new chunk within the current recording

Usage

bl record chunk start [OPTIONS]

Options

Option	Description
`--name <value>`	Name for the chunk
`--title <value>`	Title shown in trace viewer
`--json`	Output as JSON
`--session <value>`	Run this command in the named session (env: BL_SESSION; default: "default")

Global options

Option	Description
`-v, --verbose`	Enable debug logging

Examples

bl record chunk start
# Start a new chunk (for splitting long recordings)

bl record chunk start --name "part2" --title "Checkout Flow"

`bl record chunk stop`

Package current chunk into a ZIP file (recording stays active)

Usage

bl record chunk stop [OPTIONS]

Options

Option	Description
`-o, --output <value>`	Output file path (default: chunk.zip)
`--json`	Output as JSON
`--session <value>`	Run this command in the named session (env: BL_SESSION; default: "default")

Global options

Option	Description
`-v, --verbose`	Enable debug logging

Examples

bl record chunk stop
# Save chunk to chunk.zip

bl record chunk stop -o part1.zip

On this page