bl session

Manage named browser sessions (isolated cookies/storage)

Usage

bl session [OPTIONS]
bl session <command>

Option	Description
`--headless`	Hide browser window (visible by default)
`--json`	Output as JSON

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

Create a named session

Usage

bl session new <name> [OPTIONS]

Arguments

Argument	Description
`<name>`	Session name: [a-z0-9-]{1,64}

Options

Option	Description
`--isolated`	Give this session its own dedicated browser process (crash isolation)
`--headless`	Hide browser window (visible by default)
`--json`	Output as JSON

Global options

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

List active sessions

Usage

bl session list [OPTIONS]

Options

Option	Description
`--headless`	Hide browser window (visible by default)
`--json`	Output as JSON

Global options

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

Close a named session

Usage

bl session close <name> [OPTIONS]

Arguments

Argument	Description
`<name>`	Session name

Options

Option	Description
`--headless`	Hide browser window (visible by default)
`--json`	Output as JSON

Global options

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

Reset a named session (fresh storage + tab)

Usage

bl session reset <name> [OPTIONS]

Arguments

Argument	Description
`<name>`	Session name

Options

Option	Description
`--headless`	Hide browser window (visible by default)
`--json`	Output as JSON

Global options

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

Print a deterministic session name for the current directory (for parallel agents)

Usage

bl session id [OPTIONS]

Options

Option	Description
`--scope <value>`	Derivation scope: git worktree root, repo root, or current dir (default worktree)
`--prefix <value>`	Name prefix (default s)
`--headless`	Hide browser window (visible by default)
`--json`	Output as JSON

Global options

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