CLI Reference

Drive webrain by hand — every engine and tool has a CLI twin.

Commands

Command	Description
`webrain mcp [--http <port>]`	Start the MCP server (stdio, or HTTP on a port)
`webrain install [--force] [--engine chrome\|obscura\|lightpanda\|whisper\|vision\|watch] [--stealth] [--model small.en]`	Download a browser engine, or the local AI stack: `watch` = ffmpeg+yt-dlp+whisper-cli+model, `whisper` = STT GGUF model, `vision` = llama-server + Qwen3-VL-2B
`webrain upgrade`	Update to the latest release
`webrain obscura [--port N]`	Spawn the Obscura CDP server (default 9224)
`webrain lightpanda [--port N]`	Spawn the Lightpanda CDP server (default 9225)
`webrain launch <service> <profile> [url] [--headless] [--port N]`	Spawn a stealth Chrome with a persistent per-account profile
`webrain login <service> <profile> [url] [--port N]`	Launch + attach for interactive login
`webrain cookies [--port N] [--out file]`	Export cookies
`webrain setcookies <file>`	Import cookies
`webrain vault set\|list\|user\|rm`	Manage encrypted credentials (hidden prompts)
`webrain fetch <url>`	Attach to `CDP_URL` and fetch
`webrain watch <url\|file> [--detail transcript\|efficient\|balanced] [--max-frames N] [--resolution W] [--start S] [--end E] [--out-dir D] [--no-whisper] [--stt whisper\|gemini] [--vision]`	Transcript + frames for any video (no browser); `--vision` adds text captions (cloud key or local Qwen3-VL-2B)
`webrain screenshot <url>`	Screenshot (single or full page)
`webrain spider <url> [--depth N --pages N --respect-robots --json-urls --dfs --bestfirst --keywords k1,k2 --no-same-domain --discover-only]`	Crawl
`webrain click <i>` / `webrain type <i> <text>` / `webrain eval <js>`	Drive the `CDP_URL` backend
`webrain doctor`	Full install diagnosis — version, MCP server, CDP ports (9222/9224/9225), engine discovery, vault, `recommend`

Index-driven interaction

webrain click <i> / webrain type <i> <text> / webrain eval <js> attach to the CDP_URL backend and operate on element indices — the same elements[] array that webrain_observe / webrain_navigate return over MCP:

webrain launch <service> <profile> <url>   # real Chrome on a persistent profile
webrain click 3                            # click element #3
webrain type 5 "text"                      # type into element #5
webrain eval 'document.querySelector("#email").value'

Get the element list from the MCP side (webrain_observe what=state or what=a11y returns elements[] with these indices), or run webrain fetch <url> to load a page and see its element count. For CSS selectors use the MCP tools instead: webrain_observe what=html accepts a selector, webrain_extract mode=schema is driven entirely by selectors, and webrain_interact action=wait accepts a selector.

`webrain doctor`

Exit codes: 0 healthy, 2 broken. Checks the install end to end — engines, MCP server, CDP ports, vault — and prints a recommend line. The first step in any troubleshooting session. --doctor is an alias flag.

Getting Started

MCP Clients

Concepts

Agent

Guides

Comparisons

Reference

Project

CLI Reference

CLI Reference

Commands

Index-driven interaction

`webrain doctor`

​CLI Reference

​Commands

​Index-driven interaction

​webrain doctor

CLI Reference

Commands

Index-driven interaction

`webrain doctor`