All plugins

safari

Drive the user's real Safari on macOS. Safari has no Chrome DevTools Protocol, so this plugin speaks AppleScript (JXA) to Safari for tabs, navigation, DOM reads, and real native mouse/keyboard input. Because it drives the browser the user is already signed into, logged-in sites work without a separate automation profile. Registers a safari toolset (eight tools) and a hermes safari command that reports every macOS permission gate and the fix for each. Disclosure — drives your real, signed-in Safari: the agent can open any URL (including local file:// pages), read page text, run arbitrary JavaScript in any open tab, type, submit forms and send real mouse clicks on your logged-in sites without a per-action Hermes approval, and Hermes's browser website blocklist does not apply. Requires macOS Automation consent and, for page reads and scripts, Safari's "Allow JavaScript from Apple Events"; native clicks use cliclick or Accessibility, screenshots need Screen Recording. Tabs it opens are closed after an hour idle.

Thorballer1Toolsv0.1.0Updated 2 days ago

About

Drive the user's real Safari on macOS. Safari has no Chrome DevTools Protocol, so this plugin speaks AppleScript (JXA) to Safari for tabs, navigation, DOM reads, and real native mouse/keyboard input. Because it drives the browser the user is already signed into, logged-in sites work without a separate automation profile. Registers a safari toolset (eight tools) and a hermes safari command that reports every macOS permission gate and the fix for each. Disclosure — drives your real, signed-in Safari: the agent can open any URL (including local file:// pages), read page text, run arbitrary JavaScript in any open tab, type, submit forms and send real mouse clicks on your logged-in sites without a per-action Hermes approval, and Hermes's browser website blocklist does not apply. Requires macOS Automation consent and, for page reads and scripts, Safari's "Allow JavaScript from Apple Events"; native clicks use cliclick or Accessibility, screenshots need Screen Recording. Tabs it opens are closed after an hour idle.

hermes-safari

Drive the user's real Safari on macOS from Hermes.

Safari has no Chrome DevTools Protocol, so this plugin speaks AppleScript (JXA)
directly to Safari. That means it drives the browser you are actually logged
into — your session cookies are the login, and there is no separate automation
profile to authenticate.

Why not a headless / CDP browser

A CDP browser is a different browser with its own empty profile. Anything
behind a login lands on a sign-in wall. This plugin drives the real thing, so
sites you are already signed into just work.

Tools

ToolWhat it does
safari_openOpen a URL in a new tab (or window), optionally kept permanently
safari_stateList windows and tabs with titles, URLs, current tab
safari_jsEvaluate JavaScript in a tab and return the value
safari_actRead page text, find elements by CSS selector, go back
safari_clickClick by CSS selector or viewport coordinates (real OS mouse event)
safari_typeType into the focused element
safari_tabsList / select / close / navigate tabs
safari_screenshotCapture the front window to a PNG

Install

hermes plugins install https://github.com/Thorballer/hermes-safari-plugin

Or drop the directory into ~/.hermes/plugins/safari/ and enable it:

hermes plugins enable safari

macOS permissions

Three gates, each with its own failure mode. Run hermes safari to have the
plugin report which ones are missing and the exact fix for each.

  1. Automation — System Settings → Privacy & Security → Automation → allow
    your Python/Terminal to control Safari. Missing this produces
    -1712 AppleEvent timeouts or -1743 denials.
  2. JavaScript from Apple Events — Safari → Develop → Allow JavaScript from
    Apple Events
    . Required for safari_js and safari_act. Enable the Develop
    menu first in Safari → Settings → Advanced.
  3. Screen Recording — only for safari_screenshot.

Notes

  • safari_click uses a real OS-level mouse event (cliclick), so it works on
    sites that reject synthetic JS clicks.
  • Tabs opened by safari_open are closed automatically after an hour idle
    unless you pass keep=true.
  • If a page is a client-rendered SPA, the first read is often an empty shell.
    Poll safari_js returning document.body.innerText until content appears;
    a single read after a fixed sleep gives wrong answers.

License

MIT

README from the reviewed commit 4e75e3e; it updates when the author re-pins.

Developer Mode

Explore built-in Hermes toolsets and actions.

HermesAgent

Developer?

Create a Hermes extension for Desktop or agent workflows.

Developer Section