Inspect page
bl read
Read a page as markdown — fetch a URL, or omit it to read the active tab
Read a page as markdown — fetch a URL, or omit it to read the active tab
Usage
bl read [url] [OPTIONS]Arguments
| Argument | Description |
|---|---|
[url] | URL to fetch (http/https; bare host assumes https). Omit to read the active tab's live DOM |
Options
| Option | Description |
|---|---|
--raw | Return the body verbatim, without markdown extraction |
--require-md | Fail unless the response Content-Type is text/markdown |
--llms <value> | Read the nearest llms.txt (index) or llms-full.txt (full) instead of the page |
--outline | Return a compact heading outline of the page |
--filter <value> | Narrow output to sections/headings/links matching this text |
--timeout <value> | Request timeout (e.g. 5s, 30s) (default 30s) |
--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 read https://example.com
# Fetch a URL as markdown
bl read
# Read the active tab's live DOM (after navigating in a session)
bl read https://example.com --json
# Include fetch metadata (finalUrl, status, source)
bl read https://vercel.com --llms index
# List the nearest llms.txt links
bl read https://example.com/docs --outline
# Just the heading outline