Hermes Agent Safari support is now an option next to Hermes's other browser routes, and this comparison shows when the new Safari plugin is the right pick and when it is not.

Get the Backlink Gameplan →

The safari plugin joined the official Hermes plugin catalog on 18 November 2026 at the community tier, per the canary release notes.

Below you will find the options compared, the setup in brief, the common mistakes and who it suits.

Browser options for Hermes compared

OptionWhat it doesWhat it needsBest for
Safari pluginDrives your real, signed-in Safari via AppleScriptmacOS, Hermes 0.21.0+, four permission gatesTasks on sites you are already logged into
Built-in browser toolsRuns a separate automation browserNothing extraPublic pages and research
Camofox pluginRuns the Camoufox Firefox fork for HermesPlugin installSites that block standard automation
ManualYou do the clicksYour timePayments and sensitive accounts

Sources: Safari catalog entry, Hermes browser docs.

Why choose the Safari plugin

Its advantage is the login: the plugin uses the Safari you are already signed into, so there is no separate automation profile to authenticate.

It needs no Python packages; it drives the macOS osascript and defaults tools, per its README.

Setup in brief

hermes plugins install safari
hermes safari doctor
  1. Allow the Automation prompt for Safari.
  2. Enable Develop, Allow JavaScript from Apple Events.
  3. Optional: brew install cliclick plus Accessibility.
  4. Optional: Screen Recording for screenshots.

Plugin commands are covered on the Hermes plugins page.

🔥 Compare agent setups and pick the right one for each job Inside the AI Profit Boardroom you get step-by-step video trainings, the installable Agent OS, four coaching calls a week and 3,400+ members. → Join the AI Profit Boardroom

The eight tools, by permission gate

GateTools it unlocks
Automationsafari_open, safari_state, safari_tabs
JavaScript from Apple Eventssafari_js, safari_act, safari_type, selector clicks
cliclick plus Accessibilitycoordinate clicks as real OS events
Screen Recordingsafari_screenshot

Common mistakes

  1. Skipping the JavaScript gate and wondering why pages cannot be read.
  2. Running it in the main Mac account with banking signed in.
  3. Assuming the Hermes website blocklist applies; the safety note says it does not.
  4. Forgetting to re-check after a Safari update resets the JavaScript setting.
  5. Using it for public research where the built-in browser is simpler.

Rank in AI Search or It's FREE →

📈 Running SEO research through Hermes? Get your Backlink Gameplan and get the link types, the number and the authority level you need to pass your top competitor, delivered within 48 hours with a call with an SEO expert. → Get my Backlink Gameplan

Who it suits

  • Mac users whose work lives in logged-in web apps.
  • Teams that prefer Safari for its existing sessions and extensions.
  • Operators comfortable with a locked-down profile.

Who should skip it

  • Windows and Linux users (macOS only).
  • Anyone who needs per-action approval for every click.
  • Jobs that only touch public pages.

More options are in our best browser for Hermes roundup.

Safari plugin vs a fresh automation browser

PointSafari pluginFresh automation browser
LoginsUses your signed-in Safari sessionsStarts with an empty profile
PlatformmacOS onlyUsually cross-platform
Engine accessAppleScript and JXA (Safari has no DevTools protocol)Chrome DevTools protocol
Per-action approvalNone, per the catalog noteDepends on the tool
Hermes browser blocklistDoes not applyApplies to the built-in browser
DependenciesNone beyond macOS, cliclick optionalBrowser binaries and drivers

The trade-off is simple: logged-in access in exchange for fewer guard rails.

Gate-by-gate capability table

Gate openedWhat you can do
Automation consent onlyOpen URLs, list windows and tabs, switch and close tabs
Plus JavaScript from Apple EventsRead page text, find elements, run JavaScript, type, selector clicks
Plus cliclick and AccessibilityCoordinate clicks as real OS mouse events
Plus Screen RecordingWindow screenshots

The README notes a half-configured install still does something useful, because open, state and tabs need only the first gate.

Selector clicks vs coordinate clicks

Selector mode finds an element by CSS selector, scrolls it into view and clicks its centre; it needs only the JavaScript gate.

Coordinate mode clicks raw viewport positions using cliclick and real OS mouse events.

Some sites reject synthetic JavaScript clicks; with cliclick installed, even selector clicks land as genuine OS events those sites accept.

Most users can skip cliclick until a specific site refuses clicks.

Reading pages: three approaches compared

ApproachToolBest for
Full page textsafari_act text, trimmed to 20k charactersArticles and simple pages
Targeted JavaScriptsafari_js returning one valueDashboards and long pages, to save context
Screenshotsafari_screenshot plus a vision modelFallback when the JavaScript gate is off

Join the AI Profit Boardroom →

Targeted JavaScript is usually the cheapest and most accurate read.

Safety options compared

OptionProtectionEffort
Separate macOS user with limited loginsStrong: the agent only sees chosen sitesMedium
Turn Automation off when idleGood: no control between sessionsLow
Read-only prompts firstGood: no clicks or submitsLow
Run on your main account with everything signed inWeakNone

Tab housekeeping

Tabs opened by the plugin close after an hour idle, at session end, or before the next open.

Pass keep: true to keep a tab, or close one now through safari_tabs.

Install routes compared

RouteCommandNote
Catalog (recommended)hermes plugins install safariPinned to the reviewed commit
Repo URLhermes plugins install plus the GitHub URLBypasses the catalog pin
Manual cloneClone into the Hermes plugins folder, then enableFor local edits

Common mistakes

  • Dismissing the macOS consent dialog: macOS will not ask again, and every call times out or is denied until you flip the toggle by hand.
  • Skipping the Develop menu setting: without JavaScript from Apple Events the plugin can only open and list tabs.
  • Not restarting after Screen Recording: screenshots keep failing until the Hermes process restarts.
  • Reading single-page apps once: the first read is often an empty shell; poll until content appears.
  • Running on a fully signed-in main account: the agent can act on every logged-in site without per-action approval.
  • Forgetting messaging platforms: the tools only appear in Telegram or Discord once safari is added to platform_toolsets.

Troubleshooting matrix

SymptomLikely causeFix
Error -1712Consent dialog never answeredAnswer it, or enable Safari under Automation
Error -1743Consent deniedEnable Safari under Automation in System Settings
JavaScript calls fail after an updateApple Events setting clearedRe-enable in the Develop menu, rerun doctor
Screenshots failScreen Recording not granted or not appliedGrant it, restart the Hermes process
Clicks ignored on one siteSite rejects synthetic clicksInstall cliclick and grant Accessibility
Empty page textSingle-page app not rendered yetPoll safari_js until content appears

Who it suits

  • Mac users who want Hermes to work inside logged-in dashboards and admin panels.
  • Operators running repeat read tasks, such as daily numbers or competitor checks.
  • People who message Hermes from a phone and want their Mac to do browser work.

Get the Backlink Gameplan →

Who should skip it

  • Windows and Linux users, since it is macOS only.
  • Anyone who needs an approval prompt before each browser action.
  • Teams that need Hermes's browser website blocklist enforced, because it does not apply here.
  • Users on Hermes older than 0.21.0 until they upgrade.

Maturity check

The plugin is version 0.1.0, community tier, maintained by a third party, and was added to the catalog on 18 November 2026.

That is early, so treat it as a useful tool to trial on low-risk tasks rather than core infrastructure.

Watch the repo for changes and rerun hermes safari doctor after each Safari update.

Safari plugin vs Camofox vs the built-in browser

OptionBrowserLoginsBest for
Safari pluginYour real Safari, via AppleScript and JXAYour existing sessionsLogged-in dashboards and admin panels on a Mac
Camofox pluginCamoufox, a Firefox fork, in its own profileSeparate from your browserPublic sites and research at arm's length
Hermes built-in browserA separate automation browserSeparate profileGeneral browsing with Hermes's blocklist in force

Pick Safari when the job lives behind your own logins; pick a separate browser when it does not.

Decision flow

  1. Are you on a Mac running Hermes 0.21.0 or newer? If not, skip the Safari plugin.
  2. Does the task need a site you are already logged into? If not, a separate browser is safer.
  3. Can you run it from a macOS user with only the logins the task needs? If yes, the Safari plugin is a good fit.
  4. Does the task click or submit? If yes, add a human check before submit.

Read-only vs action tasks compared

Task typeTools usedRisk
Read numbers or textopen, state, js, actLow
Search inside a sitetype with submit, actLow to medium
Fill and submit formstype, clickMedium to high
Anything touching payments or settingsAnyKeep manual

Start in the first row and move down only when the prompts are proven.

Proven means the same prompt returned the right result on several separate days without you correcting it.

Gate setup time compared

GateActionEffort
AutomationClick Allow on the macOS dialogOne click
JavaScript from Apple EventsTurn on developer features, then tick the Develop menu itemTwo clicks
cliclick and AccessibilityInstall with Homebrew, grant AccessibilityA few minutes
Screen RecordingGrant in System Settings, restart the Hermes processA minute

Rank in AI Search or It's FREE →

The README says every step is a one-time click, and only the optional cliclick step needs a package install.

What it costs to run

The plugin is MIT-licensed open source with no paid tier.

Your running cost is the model behind Hermes, which depends on how much page text each task sends back.

Targeted safari_js reads keep that low; full-page text reads raise it.

Final checklist before your first real task

  • Hermes 0.21.0 or newer on macOS.
  • hermes safari doctor shows the gates you need as green.
  • A macOS user signed in only to the sites the task needs.
  • A read-only prompt with the exact URL and the value to return.
  • A plan to switch Automation off when you are done.

Tick all five and you are ready to run the first read-only task with low risk and a clear way to undo access.

Verdict

Pick the Safari plugin for logged-in Mac work with a separate profile, and learn the full agent stack in the AI Profit Boardroom.

Join the AI Profit Boardroom →

FAQ: Hermes Agent Safari Compared

Is the Safari plugin better than the built-in browser?

Only for sites where you need your existing logins. For public pages the built-in browser is simpler.

Does it need extra packages?

No Python packages. cliclick is optional for real OS mouse clicks.

Does the website blocklist apply?

No. The catalog safety note says Hermes's browser blocklist does not apply to this plugin.

Who maintains it?

Thorballer, listed as the maintainer in the catalog entry, at the community tier.

📺 Video notes + links to the tools 👉

🎥 Learn how I make these videos 👉

🆓 Get a FREE AI Course + Community + 1,000 AI Agents 👉

About Julian

I'm Julian Goldie, an SEO entrepreneur, author and founder of the AI Profit Boardroom, which has 3,400+ members.

I help business owners scale with AI agents, automation and SEO.

  • I've built a 7-figure SEO and link building agency, Goldie Agency, with a team of 70+ SEO experts.
  • I've grown a YouTube channel to 400,000+ subscribers.
  • I wrote "Link Building Mastery".
  • My Udemy courses have taught over 29,000 students.

→ Get my best AI training inside the AI Profit Boardroom

Decide which jobs need your real logins, give those to the Safari plugin and keep the rest on the built-in browser.

For guided setups, join the AI Profit Boardroom, and keep this comparison for every Hermes Agent Safari decision.