Skip to content

Releases

SafariPilot 0.3.0

Choose a tag to compare

@github-actions github-actions released this 18 Nov 00:54

Every agent session now works in a separate Safari window, and pages read closer to how they look.

New

  • A window per session: each MCP session opens tabs in a window of its own and can act only on tabs it opened. SafariPilot closes those tabs once the session ends or disconnects. Tabs left behind by a session that has ended are closed at launch.
  • Pilot tab glow: pilot tabs have a glow around the edge so you can tell them apart from your own. Screenshots leave it out.
  • Tables and grids: get_page_text with format: "markdown" reads ARIA tables and grids as markdown tables, with checkbox states, and read_page shows which column a table is sorted by. Code editors such as CodeMirror come back as fenced code blocks with their language.
  • Scrollable boxes: scrollable containers get a ref, and scroll reports the container's own scroll offset.

Changed

  • Server name: the MCP server is now called SafariPilot, so clients show tool names like mcp__SafariPilot__click. Permission rules written for mcp__safaripilot__* need the new name.
  • Modal dialogs: with a modal dialog open, reads and change reports leave out the page behind it, the same way they skip aria-hidden and inert content. When the dialog closes, the page that comes back is reported in one line.
  • Change reports: elements that re-render are matched by role and name, so the report no longer shows them as removed and added again. A reordered list is reported as a count of moved items. If a report is too long to show in full, new content comes before removed lines.
  • Server instructions are rewritten in the order an agent works: tabs, reading, acting, then errors.
  • page_fetch reads response bodies up to 5 million characters.
  • browser_batch steps take the client's prefixed tool name as well as the short one.

Fixed

  • Clicks that missed: click now works on links that WebKit folds into a larger element (for example store cards), on elements Safari exposes only as static text, and on elements whose pressable ancestor is centered off the element. If a click changes nothing on a widget that listens for pointerdown, the reply says to try the keyboard.
  • New tabs in your windows: tab_create checks which window Safari actually put the tab in, and moves the tab to a window of its own if it landed among your tabs.
  • Stuck dialogs: an animation started by an action now finishes even though the pilot window is behind yours. Before, a dialog closing with an animation could stay on screen.
  • Keys: keys sent through the page script include legacy key codes, so jQuery handlers see them, and the up and down arrows step number fields.
  • Reading: framesets, rich-text editor bodies (TinyMCE), contenteditable line breaks, checkboxes and radios with no box of their own, and words split by inline markup or set apart by spacing all read correctly. find matches plain-text elements by the text they show.
  • Empty reads: reading a PDF fails with an error instead of returning nothing. If a page hasn't rendered any text yet, the read says so. Markdown cut off by the text budget is marked as truncated.
  • tab_create returns even if the window it brings forward has closed, and closing tabs skips Safari windows that report no role.

SafariPilot 0.2.4

Choose a tag to compare

@github-actions github-actions released this 17 Nov 00:10

Agents stay out of your way in Safari.

Changed

  • No window comes forward: key and form_input on selects, dates, times and sliders now act through the page script by default, so the pilot window no longer jumps in front of your Safari windows. compat: true keeps real input for pages that ignore page events.
  • Smaller screenshots: full captures are downscaled to fit 1568 px a side and 1.15 megapixels. region crops the native capture, so zooms keep full detail.

Fixed

  • tab_create in the background: a new pilot tab or window no longer comes in front of the Safari window you are using.
  • Slider overshoot: form_input on sliders that update late, such as YouTube's seek bar, no longer overshoots the target.
  • Trusted Types pages: javascript now works on pages that require Trusted Types, such as YouTube.

SafariPilot 0.2.3

Choose a tag to compare

@github-actions github-actions released this 16 Nov 02:08

More clients and a tab placement fix.

Added

  • Set up more clients: the Clients pane and the new Set Up Client menu now configure ChatGPT and Codex, Cursor, VS Code and LM Studio alongside Claude Desktop and Claude Code. Other Clients copies a standard mcpServers entry for anything else.

Fixed

  • Agent tabs in your window: after Safari renumbered its windows, tab_create could open agent tabs in one of your own windows. It now reuses the pilot window only while every tab in it is a pilot tab.

SafariPilot 0.2.2

Choose a tag to compare

@github-actions github-actions released this 15 Nov 20:06

Verifiable downloads and a table fix.

Changed

  • Verifiable DMG: each release now carries a build provenance attestation. gh attestation verify SafariPilot-0.2.2.dmg --repo johnsusek/SafariPilotMCP confirms the DMG was built by this repo's release workflow from its tagged commit.

Fixed

  • Tables in markdown reads: a cell holding a backslash before a pipe, such as a\|b, no longer splits into two cells.

SafariPilot 0.2.1

Choose a tag to compare

@github-actions github-actions released this 15 Nov 19:30

A new toolbar icon, a simpler page_fetch, and releases built in the open.

Changed

  • Toolbar icon: Safari's toolbar shows a monochrome SafariPilot icon sized for the toolbar, instead of the app icon.
  • page_fetch sends any method: the Allow page_fetch Writes setting is gone. javascript could already send requests with any method, so the setting restricted nothing. Requests still go only to the tab's own origin or hosts in its network log, with secrets hidden.
  • Releases: each release is built, signed and notarized in GitHub Actions from its tagged commit, with a SHA-256 checksum beside the DMG. SafariPilot also installs with brew install --cask johnsusek/tap/safaripilot.

SafariPilot 0.2.0

Choose a tag to compare

@johnsusek johnsusek released this 15 Nov 16:36

Claude now does more per call: actions report what changed on the page, elements can be targeted by name, reads can be narrowed, and a site's own API calls can be sent again from inside the page.

New

  • page_fetch: sends a request from inside a tab's page, with its cookies and origin, either to a URL or as a replay of a request from read_network_requests. SafariPilot fills in the replay's auth and CSRF headers, which Claude never sees. Only GET and HEAD are sent unless you turn on Allow page_fetch Writes in the General pane.
  • Replies show what changed: click, form_input, key, drag and file_upload end with what they added, changed or removed on the page. The reply waits for the page to settle, including any fetch and XHR calls the action started.
  • Act by name: action tools take name and role in place of ref, so Claude can click "Sign in" without reading the page first. When more than one element matches, nothing is done and the candidates are listed with their refs.
  • Leaner reads: read_page with viewport returns only what is on screen. get_page_text with format: "markdown" keeps headings, lists, link URLs and tables, and with a ref_id returns just that element.
  • Timing: the Activity log shows how long each phase of a command took.

Fixed

  • form_input sets sliders, ARIA ones included (such as YouTube's seek bar), with real arrow, Home and End keys.
  • A compact JSON body that held a URL with a query string was read as a form body, so secret-named values in it were shown in network logs. They are now hidden.

Changed

  • The Clients pane shows Already set up when Claude Desktop or Claude Code already runs SafariPilot, instead of adding a second entry.
  • SafariPilot is now MIT licensed.

SafariPilot 0.1.0

Choose a tag to compare

@johnsusek johnsusek released this 15 Nov 01:22

First release. SafariPilot lets Claude use your signed-in Safari over MCP, in its own tabs, with Safari left in the background.

Open the DMG, drag SafariPilot to Applications, open it and follow setup. Needs macOS 26 and Safari 27.

What's in it

  • Tabs: tabs_list, tab_create, tab_select, tab_close, navigate, resize_window
  • Reading: read_page, find, get_page_text, screenshot, wait
  • Acting: click, form_input, key, scroll, scroll_to, drag, file_upload, handle_dialog, browser_batch
  • Debugging: javascript, read_console_messages, read_network_requests with fetch and XHR bodies
  • Real clicks and key presses through Accessibility, checked after each action
  • Same- and cross-origin iframes, read and acted in
  • Approval per client, access to its own tabs only, and secrets hidden in fields, URLs, cookies, headers and bodies
  • Every failure names a code, whether to retry, and what to do next
  • One-click setup for Claude Desktop and Claude Code

Known limits

  • No hover. Drag uses scripted events, which some drag libraries ignore.
  • Safari 27 skips network logging for a new tab's first page load (WebKit bug 315367); later loads are logged.