CLI Flags
All command-line flags for @ulpi/browse.
| Flag | Description |
|---|
--session <id> | Named session — isolates tabs, refs, cookies. Auto-persists on close. |
--profile <name> | Persistent browser profile — own Chromium instance, full state across runs. |
--state <path> | Load state file (cookies/storage) before first command. |
| Flag | Description |
|---|
--json | Wrap output as {success, data, command}. |
--content-boundaries | Wrap page content in nonce-delimited markers (prompt injection defense). |
--max-output <n> | Truncate output to N characters. |
| Flag | Description |
|---|
--headed | Run browser in headed (visible) mode. |
--cdp <port> | Connect to Chrome on a specific debugging port. |
--connect | Auto-discover and connect to a running Chrome instance. |
--chrome | Use system Chrome with real user profile. Shortcut for --runtime chrome --headed. |
--runtime <name> | Browser engine: playwright (default), rebrowser (stealth), lightpanda, chrome (system Chrome). |
--provider <name> | Cloud browser provider: browserbase, browserless. |
| Flag | Description |
|---|
--mcp | Run as MCP (Model Context Protocol) server for Cursor, Claude Desktop, Windsurf. |
| Flag | Description |
|---|
--allowed-domains <d,d> | Comma-separated domain allowlist. Blocks navigation and resources outside the list. |