Hermes Agent Safari support now comes from a new Safari plugin in the official Hermes plugin catalog. It lets Hermes drive your real Safari browser on a Mac, the one you are already signed into, so it can work on sites like your email, CRM or dashboards without a separate login. It was added to the catalog in the 18 November 2026 canary release. This guide shows what it does, how to install it, the Mac permissions it needs, and the safety rules you should follow before you turn it on.
📺 Watch: NEW Hermes Desktop Browser Update Is INSANE!
🔥 Get the Agent OS as a free bonus: AI Profit Boardroom members get the full Agent OS zip, prompt libraries, daily tutorials and weekly live coaching calls. → Get inside
What the Hermes Agent Safari Plugin Does
Most AI browser tools open a separate, empty browser. That browser has no cookies and no logins, so anything behind a sign-in page is blocked. You end up logging in again and again, or giving the agent your passwords.
The Safari plugin works differently. Safari doesn't support the Chrome DevTools Protocol that most browser agents use, so the plugin talks to Safari with AppleScript (JXA), the scripting system built into macOS. That means it controls the Safari window you already use. Your existing session cookies act as the login.
According to its catalog entry, the plugin adds a safari toolset with eight tools:
- safari_open opens a URL.
- safari_state reports what is on the current page.
- safari_tabs lists and switches tabs.
- safari_js runs JavaScript in a tab.
- safari_act reads page text, finds things, and goes back.
- safari_click clicks by selector or screen position.
- safari_type types into fields.
- safari_screenshot takes a screenshot of the window.
It also adds a hermes safari command that checks every macOS permission the plugin needs and tells you how to fix anything that's missing. It only runs on macOS, it is a community plugin (maintainer: Thorballer), and it needs Hermes 0.21.0 or newer.
Want ready-made Hermes workflows that use browser tools safely? Inside the AI Profit Boardroom we share our Agent OS setups and walk through them on weekly live calls.
Why It Matters: Speed and Cost
The big win is time. A headless browser hits a sign-in wall on most useful sites, so you have to set up a separate automation profile or skip those tasks. With Safari, the agent can work on tools you are already logged into, such as checking a dashboard, pulling a report or filling a form you fill every week.
There is a cost angle too. When an agent can't get past a login, it retries, takes screenshots and burns tokens going in circles. Starting from a signed-in session means fewer wasted steps. And because the plugin reads page text and runs JavaScript directly, the agent often doesn't need to send big screenshots to a vision model, which uses far more tokens than text.
📺 Watch: Hermes Agent OS Can Automate EVERYTHING?! 🤯
How to Install the Hermes Agent Safari Plugin
The plugin README gives one main install command, from the Hermes plugin catalog:
hermes plugins install safari
That clones the plugin, pins it to the commit listed in the catalog, and installs it. Then check it:
hermes plugins list | grep safari
hermes safari doctor
The README says the plugin has no Python dependencies. It uses the osascript and defaults tools that ship with macOS. The only optional extra is cliclick, which gives real mouse clicks for sites that block fake JavaScript clicks:
brew install cliclick
Hermes general plugins are off by default until you enable them. If yours doesn't show as enabled, run hermes plugins enable safari.
📺 Watch: Stop Finding Leads Manually! Use Hermes Agent
Mac Permission Steps
The plugin works in layers. Each Mac permission unlocks more tools. Do them in this order:
Step 0: check what you have
Run hermes safari status. It prints whether Safari is installed and running, whether Automation is allowed, whether cliclick is present, and whether JavaScript from Apple Events is on. Anything showing false is a step you still need.
Step 1: Automation consent (needed for everything)
The first time Hermes talks to Safari, macOS asks if Python (or your terminal) can control Safari. Click Allow. If you missed it, go to System Settings, Privacy & Security, Automation, find your Python or Terminal app and switch Safari on. This unlocks open, state and tabs.
Step 2: allow JavaScript from Apple Events
In Safari, open Settings, Advanced and tick Show features for web developers. Then in the menu bar choose Develop, Allow JavaScript from Apple Events. This is the step that turns the plugin into a real browser driver. It unlocks JavaScript, page reading, typing and selector clicks. A Safari update can reset it, so re-run hermes safari doctor if things stop working.
Step 3: cliclick and Accessibility (optional)
If you installed cliclick, macOS will ask for Accessibility permission the first time it clicks. You can also turn it on in System Settings, Privacy & Security, Accessibility.
Step 4: Screen Recording (screenshots only)
For screenshots, enable your Python or Terminal app in System Settings, Privacy & Security, Screen Recording, then restart that app.
Step 5: check it all
Run hermes safari doctor again. Green on every gate means every tool is live.
We set up and test our agents on real tasks, and we compare models on Goldie Bench so you can pick based on results. For the bigger picture of how we run agents, see our free Agent OS guide.
Safety Warning: Read This Before You Turn It On
This plugin is powerful because it uses your real, signed-in browser. That is also the risk. The plugin's own catalog disclosure says, in plain terms:
- The agent can open any URL, including local files on your Mac.
- It can read page text and run any JavaScript in any open tab.
- It can type, submit forms and click on your logged-in sites without asking you first for each action.
- Hermes's own browser website blocklist does not apply to it.
- Tabs it opens are closed after an hour of being idle.
So treat it like handing someone your unlocked laptop. Our rules:
- Close sensitive tabs first. Banking, payment and admin tabs should not be open while the agent works.
- Use a separate Mac user or Safari profile for agent work if you can, signed into only the sites the task needs.
- Start with read-only jobs. Let it read dashboards and pull reports before you let it fill forms.
- Watch out for prompt injection. A web page can hide text telling the agent to do something else. Don't point it at random sites while you're signed into important accounts.
- Never let it buy, send money or change passwords. Keep those jobs for yourself.
- Turn it off when you're done with
hermes plugins disable safari.
Want our safe, tested browser workflows instead of building from scratch? The AI Profit Boardroom has them, with daily tutorials and weekly coaching calls.
Good First Tasks to Try
- "Open my analytics dashboard in Safari and summarize this week's traffic."
- "Read the new messages in my support inbox tab and draft replies, but don't send them."
- "Go through these five supplier pages and put the prices and delivery times in a table."
- "Check my Google Business Profile tab and list any unanswered reviews."
Notice the pattern: read, summarize and draft. Keep the final click for yourself.
Safari Plugin vs Other Hermes Browser Options
Hermes already has browser tools. Our guides to Hermes Agent browser setups and Hermes Agent browser use cover them. The Safari plugin is for one case: you're on a Mac, you use Safari every day, and the job needs your logged-in sessions. If the task doesn't need a login, a separate browser is safer, because it can't touch your real accounts.
FAQ
Is the Hermes Safari plugin official?
It is listed in the official Hermes plugin catalog as a community-tier plugin, maintained by Thorballer. The catalog pins it to a reviewed commit.
Does it work on Windows or Linux?
No. It only works on macOS, because it uses AppleScript to control Safari.
How do I check if the permissions are set up?
Run hermes safari doctor. It lists every macOS permission gate and the fix for anything missing.
Do I need to install anything else?
No. The plugin uses tools built into macOS. cliclick is optional, only for real mouse clicks.
Is it safe to use?
It can act on your signed-in sites without asking for each step, so use it with care: close sensitive tabs, start with read-only tasks and keep payments and passwords to yourself.











