State
bl cookies
Manage browser cookies
Manage browser cookies
Usage
bl cookies [args...] [OPTIONS]
bl cookies <command>Arguments
| Argument | Description |
|---|---|
[args...] | Legacy set form: <name> <value> (prefer cookies set); omit to list |
Options
| Option | Description |
|---|---|
--domain <value> | Filter listed cookies by domain |
--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 cookies
# List all cookies
bl cookies --domain example.com
# List cookies for a domain
bl cookies get session
# Show the "session" cookie
bl cookies set session abc123
# Set a cookie with name and value
bl cookies delete session
# Delete the "session" cookiebl cookies get
Print the cookie(s) matching a name
Usage
bl cookies get <name> [OPTIONS]Arguments
| Argument | Description |
|---|---|
<name> | Cookie name to look up |
Options
| Option | Description |
|---|---|
--domain <value> | Restrict the match to this domain |
--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 cookies get session
# Show every domain/path variant named "session"bl cookies set
Set a cookie (name, value, optional domain/path/attributes)
Usage
bl cookies set <name> <value> [OPTIONS]Arguments
| Argument | Description |
|---|---|
<name> | Cookie name |
<value> | Cookie value |
Options
| Option | Description |
|---|---|
--domain <value> | Cookie domain (defaults to the current page host) |
--path <value> | Cookie path (defaults to /) |
--secure | Mark the cookie Secure (HTTPS-only) |
--http-only | Mark the cookie HttpOnly (invisible to page JavaScript) |
--same-site <value> | SameSite policy ("none" requires --secure) |
--expiry <value> | Expiry as unix seconds (omit for a session cookie) |
--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 cookies set session abc123 --domain example.com
# Set a domain-scoped cookie
bl cookies set session abc123 --secure --http-only --expiry 1893456000
# Set a protected persistent cookiebl cookies delete
Delete the cookie(s) matching a name
Usage
bl cookies delete <name> [OPTIONS]Arguments
| Argument | Description |
|---|---|
<name> | Cookie name to delete |
Options
| Option | Description |
|---|---|
--domain <value> | Restrict deletion to this domain |
--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 cookies delete session
# Delete matching cookie(s)bl cookies clear
Clear all cookies (optionally by domain)
Usage
bl cookies clear [OPTIONS]Options
| Option | Description |
|---|---|
--domain <value> | Only clear cookies for this domain |
--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 cookies clear
# Delete all cookies
bl cookies clear --domain example.com
# Delete a domain's cookies