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 |
|---|
--context | Append [context] state delta to write command responses (URL, title, tabs, dialogs, errors). |
--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, camoufox (anti-detection Firefox), chrome (system Chrome). |
--camoufox-profile <name> | Named camoufox config profile from .browse/camoufox-profiles/<name>.json. Only applies when starting a new server — ignored if a server is already running. Stop the server first with browse stop to switch profiles. |
--provider <name> | Cloud browser provider: browserbase, browserless. |
| Flag | Description |
|---|
--mcp | Run as MCP (Model Context Protocol) server for Cursor, Claude Desktop, Windsurf. |
| Flag | Description |
|---|
--platform android|ios|macos | Target platform (default: browser). |
--app <name> | App package name (Android), bundle ID (iOS), or process name (macOS). |
--device <serial> | Device serial (Android) or simulator UDID (iOS). |
--visible | Open simulator/emulator window (default: headless). Used with sim start. |
| Flag | Description |
|---|
--allowed-domains <d,d> | Comma-separated domain allowlist. Blocks navigation and resources outside the list. |