// Use the stealth browser for human-like web automation against bot-protected sites. Handles login flows, scraping, and form filling with anti-detection bypass.
| name | stealth-browse |
| description | Use the stealth browser for human-like web automation against bot-protected sites. Handles login flows, scraping, and form filling with anti-detection bypass. |
Use the stealth_browser tool for web automation that requires anti-bot bypass or human-like interaction fidelity.
| Scenario | Use |
|---|---|
| Control a browser the user already opened | cdp_browser |
| Automate a site with Cloudflare/Turnstile protection | stealth_browser |
| Screenshot an internal tool page | cdp_browser |
| Log into a web service, scrape content | stealth_browser |
| Export a page to PDF | cdp_browser |
| Fill forms with human-like delays and mouse movement | stealth_browser |
A session persists across tool calls within a turn. The first goto call launches a headless Chromium; subsequent calls reuse it. The session auto-closes after 5 minutes of inactivity or when the turn ends.
stealth_browser action=goto url="https://example.com"
stealth_browser action=click selector="#login-button"
stealth_browser action=type selector="#email" text="user@example.com"
stealth_browser action=scroll to="bottom"
stealth_browser action=text selector="article"
stealth_browser action=evaluate expr="document.querySelectorAll('.item').length"
stealth_browser action=screenshot fullPage=true outPath="/workspace/tmp/page.png"
stealth_browser action=fetch url="https://api.example.com/data" method="GET"
stealth_browser action=cookies save="/workspace/tmp/cookies.json"
stealth_browser action=cookies load="/workspace/tmp/cookies.json"
stealth_browser action=status
stealth_browser action=close
Set via environment variables or the add-on settings pane:
| Variable | Description | Default |
|---|---|---|
PICLAW_STEALTH_SEED | Fingerprint seed (identity stability) | hostname |
PICLAW_STEALTH_PROFILE | Profile ID override | auto-detected per OS |
PICLAW_STEALTH_PROXY | Proxy URL (http://user:pass@host:port) | none |
PICLAW_STEALTH_HEADLESS | Headless mode (true/false) | true |
Chromium must be installed. On first use:
bunx @mochi.js/cli browsers install
page.click() — always humanClick (realistic trajectory)evaluate takes zero-arg functions only — return JSON-serializable valuesExport a chat timeline to a PDF using the internal localhost export endpoint and wkhtmltopdf.
Nightly Bayesian interaction-quality classifier — flags behavioral patterns from chat history and writes self-improvement reflections without spending model tokens on classification.
Record major friction or postmortem feedback in the configured workspace vent log.
Open a spreadsheet-style widget for a Markdown table so the user can edit it and send the final Markdown table back into chat.
git_history and json_query tools for structured git log exploration and jq-style JSON querying.
Use `code_search` and `code_rewrite` for syntax-aware code search and refactors when structure matters.