High-risk tools in OpenChrome

Set or clear geolocation override.

Request cancellation of a background task. Best-effort: the runner

Execute multi-step browser actions from a natural language instruction. Parses and runs click, type, select, scroll, hover, navigate, and wait steps in sequence.\n\nWhen to use:...

Execute JS across multiple tabs in parallel.

Emulate device viewport and UA via preset or custom.

Execute a cached plan by ID, bypassing per-step LLM calls. Falls back gracefully on failure for manual retry.

Execute JavaScript code in the context of the current page. The code runs in the page

Navigate to a URL, or go forward/back in browser history. Use

Capture a CDP performance trace and return named insights

Pilot-only bounded deterministic recovery wrapper for one tool call under declared safe recipes. Requires --pilot and OPENCHROME_CONTRACT_RUNTIME=1.

Start an opt-in OpenChrome run ledger. Returns {run_id,status,pathless metadata}.

Shut down OpenChrome and close Chrome. Auto-relaunched on next tool call.

Enter a terminal TaskRun state (COMPLETED, FAILED, or CANCELLED). Terminal TaskRuns are immutable.

Start an opt-in goal-level TaskRun. Tracks user goal, success criteria, progress summary, item progress, and evidence across multiple OpenChrome tool calls without changing exis...

Create a task-level browser harness envelope, or launch a long-running tool as a background task. Returns a task_id

Block until the task reaches a terminal state (COMPLETED / FAILED /

Wait for a condition. Strongly prefer

Use a mouse and keyboard to interact with a web browser, and take screenshots.

Recursively crawl a website via BFS. Opens pages in new tabs, extracts text and links, follows them up to max_depth. Respects robots.txt and scope constraints.\n\nWhen to use: E...

Find element by natural language; click/hover/double_click it; wait for DOM settle; return state.\n\nWhen to use: One described element action, with coordinate fallback for Shad...

Simulate network conditions.

Pilot-tier: redeem a single-use handoff token previously minted by

Pilot-tier (--pilot + OPENCHROME_PROXY_HOOK=1): bind host-supplied

Pilot-tier. Replay a recorded skill (steps + optional contract)

Finish a host-driven task envelope as completed, failed, or cancelled.

Generate PDF from page. Saves to path or returns base64.

Reload the current page.

Initialize a workflow with multiple isolated workers for parallel browser ops.

Drag and drop by selector or coordinates. Pass intent=

Upload files to a file input element on the page. Pass intent=

Fill form fields and optionally submit. Pass intent=

Set values in form elements using element reference ID from the read_page tool.

Scroll page via JS. Returns new scroll position.

Copy text to the system clipboard. Useful for copying MCP server URLs or config snippets.

Open the MCP connector settings page for a web AI host in the default browser.

Pilot-tier: mint a single-use handoff token that lets another agent

Restore working context after context compaction.

Generate a current TOTP 2FA code for a domain. Requires TOTP secret to be configured.

Creates a new empty tab in the MCP session

Manage workers. Actions: