Session
bl stop
Stop the current session's run — the lifecycle counterpart to `start`.
Stop the current session's run — the lifecycle counterpart to start.
Closes this session's tabs/context. It does NOT stop the shared background
browser, so other sessions stay alive and the browser stays warm for the next
command (it shuts itself down after its idle timeout). Stopping an --isolated
session closes its own dedicated browser.
Use `--session <name>` to stop a specific session. To close the browser
entirely — every session and the background process — use `bl quit`.Usage
bl 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 stop
# Stop the current session (browser stays warm)
bl stop --session checkout
# Stop a specific named session
bl quit
# Close the browser entirely (every session ends)bl start
Explicitly start/activate the current session — the lifecycle counterpart to `stop`. Creates or reuses this session's browser context/tab; a named session (`--session <name>`) that was stopped or never created is started fresh, so a session name can be re-run after `bl stop`.
bl session
Manage named browser sessions (isolated cookies/storage)