Check if ZenLink bridge and browser extension are connected.

List all open browser tabs with their IDs, titles, and URLs.

Get current page URL, title, dimensions, and scroll position.

Args: tab_id: Optional tab to target. Defaults to active tab.

Extract all readable text from the current page.

Args: tab_id: Optional tab to target. Defaults to active tab. For non-active tabs, prefer this with tab_id over zen_page_text_by_tab_id — they do the same thing now.

Get page text from a specific tab by ID without switching to it.

Args: tab_id: The tab ID to read from (get IDs from zen_tabs)

Returns the full visible text content of the specified tab.

Get all form fields on the current page with their labels and values.

Args: tab_id: Optional tab to target. Defaults to active tab.

Get the accessibility tree of interactive elements on the page.

Args: tab_id: Optional tab to target. Defaults to active tab.

Capture a screenshot of the current page. Returns the saved file path.

Note: screenshots are inherently visual and capture the active tab of the focused window. To screenshot a specific tab, switch to it first with zen_switch_tab.

Navigate the active tab to a URL.

Args: url: The URL to navigate to (e.g. "https://example.com") tab_id: Optional tab to navigate. Defaults to active tab.

Open a new browser tab.

Args: url: URL to open in the new tab (default: blank page)

Close a browser tab by its ID.

Args: tab_id: The tab ID to close (get IDs from zen_tabs)

Switch focus to a specific browser tab.

Args: tab_id: The tab ID to focus (get IDs from zen_tabs)

Click an element on the page by CSS selector or coordinates.

Args: selector: CSS selector to click (e.g. "#submit", ".btn-primary") x: X coordinate (used if selector is empty) y: Y coordinate (used if selector is empty) tab_id: Optional tab to target. Defaults to active tab.

Click using the real OS mouse pointer for pages that reject synthetic DOM events.

This is slower and moves the user's cursor, so prefer zen_click unless a page specifically ignores synthetic clicks.

Args: selector: CSS selector to click. If provided, ZenLink clicks its center. x: X coordinate, used if selector is empty. y: Y coordinate, used if selector is empty. coordinate_space: "viewport" for browser viewport coords or "screen" for desktop coords. focus: Whether to try to foreground the browser first. Defaults to false. tab_id: Optional tab to resolve the selector against (viewport coords only).

Type text into an input field.

Args: selector: CSS selector of the input element text: Text to type clear: Whether to clear existing text first tab_id: Optional tab to target. Defaults to active tab.

Set text or HTML in a contenteditable editor, input, or textarea in one fast operation.

Use this for rich editors such as Gmail compose bodies where typing long text is slow.

Args: selector: CSS selector or ZenLink ref for the editable element value: Text or HTML to place into the editor format: "text" for plain text or "html" for trusted HTML clear: Whether to replace existing content instead of appending tab_id: Optional tab to target. Defaults to active tab.

Set a form field's value directly (faster than typing).

Args: selector: CSS selector of the input/select element value: Value to set tab_id: Optional tab to target. Defaults to active tab.

Scroll the page.

Args: direction: Scroll direction - "up", "down", "left", or "right" amount: Pixels to scroll tab_id: Optional tab to target. Defaults to active tab.

Hover over an element on the page.

Args: selector: CSS selector of the element to hover over tab_id: Optional tab to target. Defaults to active tab.

Find elements on the page using natural language description.

Args: query: What to find (e.g. "login button", "search bar", "email input") tab_id: Optional tab to target. Defaults to active tab.

Execute JavaScript in the current page context.

Args: code: JavaScript code to run (e.g. "document.title" or "document.querySelectorAll('a').length") tab_id: Optional tab to target. Defaults to active tab.

Highlight an element on the page with a visual overlay.

Args: selector: CSS selector of the element to highlight tab_id: Optional tab to target. Defaults to active tab.

Wait for a CSS selector to appear and become visible on the page. Returns immediately when the element is found, rather than sleeping a fixed duration. Use this instead of sleep when waiting for dynamic/JS-rendered content.

Args: selector: CSS selector to wait for (e.g. ".tracking-events", "#results", "[data-loaded]") timeout: Maximum time to wait in milliseconds (default: 10000 = 10s) poll_interval: How often to check in milliseconds (default: 200ms) tab_id: Optional tab to target. Defaults to active tab.

Poll a JavaScript expression until it returns a non-empty result.

Args: code: JavaScript expression to evaluate repeatedly timeout: Maximum time to wait in milliseconds poll_interval: How often to check in milliseconds tab_id: Optional tab to target. Defaults to active tab.

List available named ZenLink workflows from the bridge workflow directory.

Execute a named ZenLink workflow from the bridge workflow directory.

Args: name: Workflow file name without .md variables: Optional template variables for the workflow

Control the ZenLink bridge response cache.

Args: action: "clear", "status", or "ttl" seconds: TTL value when action is "ttl"

Revive a tab that Zen's Tab Unloader may have discarded.

Zen aggressively unloads inactive tabs to save RAM. An unloaded tab still appears in zen_tabs but has no live content script — commands targeting it will hang or fail until it's reloaded. zen_wake_tab is idempotent: if the tab is already alive it returns immediately; otherwise it reloads the tab and waits for the page to finish loading.

Use before targeting a tab that might have been idle for a while. Prefer zen_keep_alive for tabs you'll touch repeatedly.

Args: tab_id: The tab ID to wake (get IDs from zen_tabs)

Keep tabs warm so Zen's Tab Unloader won't discard them mid-workflow.

Starts a background pinger in the bridge that fires a no-op JS evaluation at each listed tab on the given interval. Any script access resets Zen's idle timer, so the tabs stay loaded. Replaces any existing keep-alive for the same tabs (use a new interval to change cadence).

Use this at the start of parallel multi-tab work: open your tabs, call zen_keep_alive with their IDs, drive them in parallel via zen_parallel or by passing tab_id to individual commands, then zen_keep_alive_stop when done. The pinger auto-stops if the bridge restarts.

Args: tab_ids: Tab IDs to keep loaded. interval_seconds: How often to ping each tab. Minimum 10s, default 60s. Should be well under Zen's unloader timeout (commonly 20+ minutes).

Stop the keep-alive pinger for some or all tabs.

Args: tab_ids: Tabs to stop pinging. Omit (or pass null) to stop all.

Hot-reload the ZenLink extension in the browser.

Use this after editing the extension source to pick up changes without going through about:addons and toggling the extension by hand. The extension acks the request, then reloads itself ~100ms later; the background script's existing reconnect logic re-establishes the bridge WebSocket immediately. Content scripts in open tabs survive — they re- inject lazily on the next command (see forwardToContent in background.js).

Note: only works once you're already on a version of the extension that has this action handler. The very first install of that version requires the usual about:addons toggle.

Run command sequences in parallel — typically one sequence per tab.

Each inner list is a sequence that runs serially; all sequences run concurrently. Commands that target a specific tab (navigate, switchTab, or any tab-aware action) MUST include "tabId" inside the parallel batch to avoid race conditions over the active tab.

Returns a list of result lists, one per input sequence.

Args: sequences: List of command sequences. Each command is a dict with "action" and parameters — same shape as zen_batch commands. Example for driving two tabs at once: [ [{"action": "navigate", "url": "...", "tabId": 12}, {"action": "waitForElement", "selector": "h1", "tabId": 12}, {"action": "pageText", "tabId": 12}], [{"action": "navigate", "url": "...", "tabId": 13}, {"action": "waitForElement", "selector": "h1", "tabId": 13}, {"action": "pageText", "tabId": 13}] ]

Extract multiple fields from every element matching a CSS selector.

Much faster and cheaper than calling zen_js per element. The default fields cover the common ones (text, href, value, src, alt, id, name); pass fields=["text","data-foo","bounds","attrs"] to get arbitrary attributes or bounds/attrs/html extras.

Args: selector: CSS selector. fields: Field names to extract per element. Defaults to a useful set. limit: Max elements to return (capped at 500). tab_id: Optional tab; defaults to active.

Return the outerHTML of a specific element. Cap 100KB.

Return every anchor with href + text. Useful as a crawler primitive.

Return every with src, alt, and natural dimensions.

Return all meta tags + link rels (canonical, RSS, icons, etc.).

Extract JSON-LD blocks, OpenGraph (og:*), and Twitter card meta.

Return getBoundingClientRect + viewport/page sizes for an element.

Return computed CSS for an element. Defaults to the layout-relevant set.

Extract the main article on the page (title, byline, clean text).

Heuristic: score candidate containers (article, main, .post, etc.) by text density × paragraph count × inverse link density, strip nav/aside, return the winner. Falls back to densest section/div, then body.

Convert the page (or a selector subtree) to Markdown. Cap 80KB.

List all iframes with src + same-origin/accessible flags.

Diagnose a CSS selector: match count, sample matches, suggestions for a more-specific selector if you got too many.

Choose an in a . Default matches by value; pass by_text=True to match by visible text.

Set a checkbox or radio's checked state.

Move focus to the matched element.

Blur an element (or document.activeElement if no selector).

Dispatch a synthetic keyboard event. Use modifiers like {"ctrl": True, "shift": True}. Pass text to also insert characters into editable targets.

Args: key: Key name, e.g. "Enter", "Tab", "Escape", "ArrowDown", "a". selector: Optional element to target. Defaults to document.activeElement. modifiers: {"ctrl"|"shift"|"alt"|"meta": True}. text: If set, also insert this text into editable targets.

Dispatch a synthetic double-click on the matched element.

Submit a form. If selector is omitted, submits the first found.

Fill many fields at once via fuzzy matching.

Each key in fields is matched as: CSS selector → name attribute → label text (case-insensitive contains) → placeholder. Each value is applied via the appropriate setter (.value for inputs/textareas, .checked for checkboxes/radios, value for selects). Returns per-key results.

Args: fields: {"email": "foo@bar", "Password": "...", "#submit-target": true}

Synthetic drag-and-drop from one element to another (HTML5 drag events).

Click an element, then wait for the resulting navigation to complete.

Atomic operation — far more reliable than zen_click followed by zen_wait_for_url for links/submit buttons. Listens for tabs.onUpdated(status='complete').

Screenshot a single element. Scrolls into view, captures, crops in the extension via OffscreenCanvas. Returns a PNG data URL.

Scroll-and-stitch screenshot covering the full document height (up to 30 viewports tall). Returns one PNG data URL of the entire page.

Return document/viewport sizes + scroll position + devicePixelRatio.

Pin or unpin a tab.

Mute or unmute a tab.

Duplicate a tab. Returns the new tab id.

Reload a tab. Pass bypass_cache=True for a hard reload.

Go back in history (browser back button).

Go forward in history.

Return the current zoom factor (1.0 = 100%).

Set zoom factor. 0.3 to 5.0 typical; 1.0 = 100%.

List all open browser windows with their tabs.

Open a new browser window. Pass a URL to load it at start.

Close a browser window by ID (from zen_windows).

Bring a browser window to the foreground.

Move a tab to a position (and optionally to a different window). -1 = end.

Pop a tab out into its own new window.

Cookie operations: "get", "set", "remove", "clear".

• get: returns matching cookies (use url/domain/name to filter).

• set: requires url + name + value.

• remove: requires url + name.

• clear: clears all cookies for url or domain.

localStorage / sessionStorage ops.

Args: kind: "local" or "session". op: "get" | "set" | "remove" | "clear" | "list" | "snapshot" | "restore". key: Required for get/set/remove. value: For set, the string value. For restore, a dict of key→value. tab_id: Tab to run against. Storage is per-origin, so prefer driving it on a tab already at the right origin.

Read or write the system clipboard.

Args: op: "read" or "write". text: Text to write when op="write".

Downloads operations.

Args: op: "download" | "list" | "cancel". url: For "download", the URL to fetch. filename: Optional output filename. query: For "list", a downloads.search query dict.

Clear browsing data of the given types.

Args: types: Which to clear. Subset of ["cache","cookies","history", "localStorage","passwords","downloads"]. Default = all of those. since_ms: Only data created since this epoch-ms timestamp.

Block, log, or redirect HTTP requests by URL regex.

Useful to suppress analytics/ads during agent runs (3–10× page speed-up) or to log what an SPA actually fetches.

Args: op: "add" | "clear" | "list" | "log" | "clearLog". patterns: For "add", regex patterns to match against request URLs. effect: For "add", "block" (cancel request) or "redirect".

Capture network requests via the page's PerformanceObserver.

Args: op: "start" begins capturing fresh, "stop" pauses, "read" returns the buffer (default), "clear" empties it. since: When reading, only return entries with startTime >= since (ms). tab_id: Optional tab; defaults to active.

Wait until no new network resources have started for idle_ms.

Wait until the tab's URL matches a JS regex pattern.

Wait until document.title matches a JS regex pattern.

Toggle console capture on a tab. Once enabled, browser console messages (log/info/warn/error/debug + window errors) are buffered up to 500 entries; retrieve via zen_console_logs.

Return buffered console logs from a tab (requires zen_watch_console first).

Fire the same command at every listed tab in parallel.

Each tab gets the command with its own tabId injected. Returns per-tab results keyed by tab id.

Args: tab_ids: Tabs to target. command: Command dict, e.g. {"action": "pageInfo"} or {"action": "getReadability"}. timeout: Per-tab timeout in seconds.

Block until a JS predicate returns truthy on every listed tab.

Replaces hand-rolled "wait for everything to be ready" loops.

Args: tab_ids: Tabs to monitor. predicate: JS expression that returns truthy when the tab is ready, e.g. "!!document.querySelector('.results')". timeout: Overall timeout in ms. poll_interval: Per-poll interval in ms.

Give a tab a memorable name. Refer to it later via zen_resolve_tag. Names survive bridge restarts only if you re-tag — they live in memory.

Look up the tab id for a tag set via zen_tag_tab.

List all tag → tab id mappings.

Remove a tag.

Maintain a warm pool of N tabs always ready to be acquired.

Grows or shrinks to size. Acquire/release via zen_pool_acquire and zen_pool_release. Auto-grows by one if you acquire from an empty pool.

Check out a warm tab from the pool. Returns its tab_id.

Return a tab to the pool for reuse.

Snapshot cookies (and per-origin localStorage if urls given) to disk.

Use case: log into a service interactively once, save the session, then have parallel agents load it for authenticated work.

Args: name: A label for the session (becomes filename under ~/claude-zen-sessions/). urls: Origins whose cookies + localStorage to snapshot. Each gets opened briefly in a temp tab so localStorage can be read.

Restore cookies + localStorage from a previously saved session.

List saved sessions with their metadata.

Delete a saved session file.

Extended health/status: bridge version, ports, keep-alive list, pool state, tags, policy, sessions dir, audit/log sizes.

Return recent bridge log lines (in-memory ring buffer).

Return recent command audit entries: action, params (JS code stripped), success flag, error, duration. Useful for "what did the agent do?" reviews.

Set URL allow/deny regex lists and/or read-only mode.

Read-only mode blocks write actions (click/type/navigate/cookies set/etc.) while still allowing read ops. Useful for "let the agent observe only."