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.
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
| Option | What it does | What it needs | Best for |
|---|---|---|---|
| Safari plugin | Drives your real, signed-in Safari via AppleScript | macOS, Hermes 0.21.0+, four permission gates | Tasks on sites you are already logged into |
| Built-in browser tools | Runs a separate automation browser | Nothing extra | Public pages and research |
| Camofox plugin | Runs the Camoufox Firefox fork for Hermes | Plugin install | Sites that block standard automation |
| Manual | You do the clicks | Your time | Payments 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
- Allow the Automation prompt for Safari.
- Enable Develop, Allow JavaScript from Apple Events.
- Optional:
brew install cliclickplus Accessibility. - 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
| Gate | Tools it unlocks |
|---|---|
| Automation | safari_open, safari_state, safari_tabs |
| JavaScript from Apple Events | safari_js, safari_act, safari_type, selector clicks |
| cliclick plus Accessibility | coordinate clicks as real OS events |
| Screen Recording | safari_screenshot |
Common mistakes
- Skipping the JavaScript gate and wondering why pages cannot be read.
- Running it in the main Mac account with banking signed in.
- Assuming the Hermes website blocklist applies; the safety note says it does not.
- Forgetting to re-check after a Safari update resets the JavaScript setting.
- 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
| Point | Safari plugin | Fresh automation browser |
|---|---|---|
| Logins | Uses your signed-in Safari sessions | Starts with an empty profile |
| Platform | macOS only | Usually cross-platform |
| Engine access | AppleScript and JXA (Safari has no DevTools protocol) | Chrome DevTools protocol |
| Per-action approval | None, per the catalog note | Depends on the tool |
| Hermes browser blocklist | Does not apply | Applies to the built-in browser |
| Dependencies | None beyond macOS, cliclick optional | Browser binaries and drivers |
The trade-off is simple: logged-in access in exchange for fewer guard rails.
Gate-by-gate capability table
| Gate opened | What you can do |
|---|---|
| Automation consent only | Open URLs, list windows and tabs, switch and close tabs |
| Plus JavaScript from Apple Events | Read page text, find elements, run JavaScript, type, selector clicks |
| Plus cliclick and Accessibility | Coordinate clicks as real OS mouse events |
| Plus Screen Recording | Window 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
| Approach | Tool | Best for |
|---|---|---|
| Full page text | safari_act text, trimmed to 20k characters | Articles and simple pages |
| Targeted JavaScript | safari_js returning one value | Dashboards and long pages, to save context |
| Screenshot | safari_screenshot plus a vision model | Fallback when the JavaScript gate is off |
Join the AI Profit Boardroom →
Targeted JavaScript is usually the cheapest and most accurate read.
Safety options compared
| Option | Protection | Effort |
|---|---|---|
| Separate macOS user with limited logins | Strong: the agent only sees chosen sites | Medium |
| Turn Automation off when idle | Good: no control between sessions | Low |
| Read-only prompts first | Good: no clicks or submits | Low |
| Run on your main account with everything signed in | Weak | None |
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
| Route | Command | Note |
|---|---|---|
| Catalog (recommended) | hermes plugins install safari | Pinned to the reviewed commit |
| Repo URL | hermes plugins install plus the GitHub URL | Bypasses the catalog pin |
| Manual clone | Clone into the Hermes plugins folder, then enable | For 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
safariis added toplatform_toolsets.
Troubleshooting matrix
| Symptom | Likely cause | Fix |
|---|---|---|
| Error -1712 | Consent dialog never answered | Answer it, or enable Safari under Automation |
| Error -1743 | Consent denied | Enable Safari under Automation in System Settings |
| JavaScript calls fail after an update | Apple Events setting cleared | Re-enable in the Develop menu, rerun doctor |
| Screenshots fail | Screen Recording not granted or not applied | Grant it, restart the Hermes process |
| Clicks ignored on one site | Site rejects synthetic clicks | Install cliclick and grant Accessibility |
| Empty page text | Single-page app not rendered yet | Poll 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.
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
| Option | Browser | Logins | Best for |
|---|---|---|---|
| Safari plugin | Your real Safari, via AppleScript and JXA | Your existing sessions | Logged-in dashboards and admin panels on a Mac |
| Camofox plugin | Camoufox, a Firefox fork, in its own profile | Separate from your browser | Public sites and research at arm's length |
| Hermes built-in browser | A separate automation browser | Separate profile | General 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
- Are you on a Mac running Hermes 0.21.0 or newer? If not, skip the Safari plugin.
- Does the task need a site you are already logged into? If not, a separate browser is safer.
- Can you run it from a macOS user with only the logins the task needs? If yes, the Safari plugin is a good fit.
- Does the task click or submit? If yes, add a human check before submit.
Read-only vs action tasks compared
| Task type | Tools used | Risk |
|---|---|---|
| Read numbers or text | open, state, js, act | Low |
| Search inside a site | type with submit, act | Low to medium |
| Fill and submit forms | type, click | Medium to high |
| Anything touching payments or settings | Any | Keep 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
| Gate | Action | Effort |
|---|---|---|
| Automation | Click Allow on the macOS dialog | One click |
| JavaScript from Apple Events | Turn on developer features, then tick the Develop menu item | Two clicks |
| cliclick and Accessibility | Install with Homebrew, grant Accessibility | A few minutes |
| Screen Recording | Grant in System Settings, restart the Hermes process | A 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 doctorshows 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.











