bl record

Record browser sessions (screenshots and snapshots)

Usage

bl record [flags]
bl record [command]

Global flags

Flag	Description
`--headless`	Hide browser window (visible by default)
`--json`	Output as JSON
`-v, --verbose`	Enable debug logging

`bl record chunk`

Manage recording chunks

Usage

bl record chunk [flags]
bl record chunk [command]

Global flags

Flag	Description
`--headless`	Hide browser window (visible by default)
`--json`	Output as JSON
`-v, --verbose`	Enable debug logging

`bl record chunk start`

Start a new chunk within the current recording

Usage

bl record chunk start [flags]

Flags

Flag	Description
`--name string`	Name for the chunk
`--title string`	Title shown in trace viewer

Global flags

Flag	Description
`--headless`	Hide browser window (visible by default)
`--json`	Output as JSON
`-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 [flags]

Flags

Flag	Description
`-o, --output string`	Output file path (default: chunk.zip)

Global flags

Flag	Description
`--headless`	Hide browser window (visible by default)
`--json`	Output as JSON
`-v, --verbose`	Enable debug logging

Examples

bl record chunk stop
# Save chunk to chunk.zip

bl record chunk stop -o part1.zip

`bl record group`

Manage recording groups

Usage

bl record group [flags]
bl record group [command]

Global flags

Flag	Description
`--headless`	Hide browser window (visible by default)
`--json`	Output as JSON
`-v, --verbose`	Enable debug logging

`bl record group start`

Start a named group in the recording

Usage

bl record group start <name> [flags]

Global flags

Flag	Description
`--headless`	Hide browser window (visible by default)
`--json`	Output as JSON
`-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 [flags]

Global flags

Flag	Description
`--headless`	Hide browser window (visible by default)
`--json`	Output as JSON
`-v, --verbose`	Enable debug logging

Examples

bl record group stop

`bl record start`

Start a recording

Usage

bl record start [flags]

Flags

Flag	Description
`--bidi`	Record raw BiDi commands in the recording
`--format string`	Screenshot format: jpeg or png (default "jpeg")
`--name string`	Name for the recording
`--quality float`	JPEG quality 0.0-1.0 (ignored for png) (default 0.5)
`--screenshots`	Capture screenshots after each action (default true)
`--snapshots`	Capture HTML snapshots
`--sources`	Include source information
`--title string`	Title shown in trace viewer (defaults to name)

Global flags

Flag	Description
`--headless`	Hide browser window (visible by default)
`--json`	Output as JSON
`-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 [flags]

Flags

Flag	Description
`-o, --output string`	Output file path (default: record.zip)

Global flags

Flag	Description
`--headless`	Hide browser window (visible by default)
`--json`	Output as JSON
`-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

On this page