bl storage

Save, load, and manage named session storage snapshots

Usage

bl storage
bl storage <command>

Global options

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

Examples

bl storage save github
# Snapshot the current session's storage as "github"

bl storage load github
# Restore the "github" snapshot into the current session

bl storage list
# List saved snapshots

`bl storage save`

Save the current session's storage as a named snapshot

Usage

bl storage save <name> [OPTIONS]

Arguments

Argument	Description
`<name>`	Snapshot name to save (overwrites if it exists)

Options

Option	Description
`--headless`	Hide browser window (visible by default)
`--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 storage save github
# Save cookies + localStorage + sessionStorage

`bl storage load`

Restore a named snapshot into the current session

Usage

bl storage load <name> [OPTIONS]

Arguments

Argument	Description
`<name>`	Snapshot name to load

Options

Option	Description
`--headless`	Hide browser window (visible by default)
`--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 storage load github
# Restore cookies and web storage

`bl storage list`

List saved storage snapshots

Usage

bl storage list [OPTIONS]

Options

Option	Description
`--json`	Output as JSON

Global options

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

Examples

bl storage list
# Show saved snapshot names + counts

`bl storage show`

Show a snapshot's metadata and counts (never raw values)

Usage

bl storage show <name> [OPTIONS]

Arguments

Argument	Description
`<name>`	Snapshot name to show

Options

Option	Description
`--json`	Output as JSON

Global options

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

Examples

bl storage show github
# Print redacted metadata

`bl storage delete`

Delete a saved storage snapshot

Usage

bl storage delete <name> [OPTIONS]

Arguments

Argument	Description
`<name>`	Snapshot name to delete

Options

Option	Description
`--json`	Output as JSON

Global options

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

Examples

bl storage delete github
# Remove the saved snapshot

`bl storage export`

Export a snapshot's canonical JSON to a file

Usage

bl storage export <name> [OPTIONS]

Arguments

Argument	Description
`<name>`	Snapshot name to export

Options

Option	Description
`-o, --output <value>`	Destination file path
`--json`	Output as JSON

Global options

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

Examples

bl storage export github -o github.json
# Write canonical JSON to a file

`bl storage import`

Import canonical JSON from a file into the registry

Usage

bl storage import <path> [OPTIONS]

Arguments

Argument	Description
`<path>`	Path to a canonical storage JSON file

Options

Option	Description
`--name <value>`	Name to store the imported snapshot under
`--json`	Output as JSON

Global options

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

Examples

bl storage import github.json --name github
# Validate and store under a name

On this page