Field notes · AI agents, Hermes & Claude Code By Julian Goldie

Hermes Agent Safari: Install the Safari Plugin, Open Every macOS Permission Gate and Lock It Down

The 18 November Safari plugin, installed step by step: Automation, JavaScript from Apple Events, cliclick, Screen Recording, then the safety settings.

Get The AI Profit Stack Join AIPB →
  • 01 1,000+ done-for-you AI agent workflows
  • 02 5 live coaching calls / week with me
  • 03 7-day refund, cancel anytime
  • 04 3,400+ AI operators inside

Hermes Agent Safari support arrived on 18 November 2026, when a safari plugin was added to the official Hermes plugin catalog, and this guide walks through the install, every macOS permission gate and the safety settings to change first.

Get the Backlink Gameplan →

The plugin lets Hermes drive your real Safari on a Mac: open tabs, read pages, fill forms and click, using the logins you already have.

Safari has no Chrome DevTools Protocol, so the plugin talks to Safari through AppleScript (JXA) instead, per its catalog entry.

Before you start, read the safety section below, because this plugin acts on signed-in sites without asking each time.

What shipped and when

  • The catalog entry landed in the 18 November canary build (commit 1addeb7b), with a follow-up review commit.
  • Tier: community; maintainer: Thorballer; version 0.1.0.
  • Requires Hermes 0.21.0 or newer and runs on macOS only.
  • It registers a safari toolset with eight tools and a hermes safari command.

Step 1: install from the catalog

hermes plugins install safari
hermes plugins list | grep safari     # -> safari  enabled

The catalog install pins the plugin to the reviewed commit and enables it, per the plugin README.

Hermes plugin commands are documented on the plugins page.

Step 2: check what is missing

hermes safari status    # JSON: safari_installed, automation, cliclick, allow_js_from_apple_events
hermes safari doctor    # every permission gate, with the fix for each

Anything that reads false is a gate you still need to open.

Step 3: Automation consent

The first time Hermes sends an AppleEvent, macOS asks whether Python may control Safari; click Allow.

If you dismissed it, go to System Settings, Privacy and Security, Automation, find your Python or Terminal entry and switch Safari on.

Errors -1712 or -1743 mean this gate is still closed.

This unlocks safari_open, safari_state and safari_tabs.

Step 4: Allow JavaScript from Apple Events

In Safari open Settings, Advanced, and tick "Show features for web developers".

Then choose Develop, Allow JavaScript from Apple Events from the menu bar.

This is the gate that turns the plugin from a tab opener into a real browser driver: it unlocks safari_js, safari_act, safari_type and selector clicks.

A Safari update can reset it, so rerun hermes safari doctor if JavaScript calls start failing.

🔥 Want Hermes running browser jobs for your business? 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 wiring up the same agents. → Join the AI Profit Boardroom

Rank in AI Search or It's FREE →

Step 5: optional cliclick and Accessibility

brew install cliclick
cliclick sends real OS mouse events, which some sites need, and enables coordinate clicks.

The binary that runs it needs Accessibility permission under System Settings, Privacy and Security, Accessibility.

Step 6: Screen Recording for screenshots

Enable your Python or Terminal under Privacy and Security, Screen Recording, then restart that process.

That unlocks safari_screenshot, the fallback read path when JavaScript is off.

The eight tools and their gates

ToolWhat it doesNeeds
safari_openOpen a URL in a new tab or windowAutomation
safari_stateList windows and tabsAutomation
safari_tabsList, select, close or navigate tabsAutomation
safari_jsRun JavaScript in a tab and return the valueJS from Apple Events
safari_actRead page text, find elements, go backJS from Apple Events
safari_typeType into a field, optionally submitJS from Apple Events
safari_clickClick by selector or by screen coordinatesJS, or cliclick for coordinates
safari_screenshotCapture the front window as a PNGScreen Recording

Use it from Telegram or Discord

Add the toolset to the platform list in config.yaml:

platform_toolsets:
  telegram:
    - safari

Safety: read the catalog safety note

The reviewed catalog entry says the agent can open any URL, including local file pages, read page text, run any JavaScript in any open tab, type, submit forms and click on your logged-in sites without a per-action Hermes approval.

It also says Hermes's browser website blocklist does not apply to this plugin.

Run it in a separate macOS user or Safari profile with only the logins the job needs, and keep banking and email signed out.

Tabs the plugin opens are closed after an hour idle, or at session end, unless you pass keep: true.

📈 Using Hermes for SEO research in Safari? Get your Backlink Gameplan and my team will reverse engineer why your competitors rank: their links, how many you need and which sites to target, within 48 hours, with a call with an SEO expert. → Get my Backlink Gameplan

Safari plugin vs the built-in browser

Hermes's own browser tools run a separate automation browser with an empty profile, so logged-in sites hit sign-in walls; the Safari plugin uses your real session instead.

Join the AI Profit Boardroom →

For other browser options, see our Hermes Agent browser guide and our Camofox plugin walkthrough.

No dependencies, and other install routes

The plugin README says it is pure Python standard library and drives the osascript and defaults binaries that ship with macOS, so there is nothing to pip install.

The catalog install pins the plugin to the catalogued commit and installs it enabled.

Two other routes exist: install straight from the repo URL with hermes plugins install https://github.com/Thorballer/hermes-safari-plugin, which bypasses the catalog pin, or clone it into ~/.hermes/plugins/safari and run hermes plugins enable safari.

Stick with the catalog route unless you need an unreleased fix, because the pin is what the catalog reviewers looked at.

What hermes safari status returns

The status command prints JSON with five fields: safari_installed, safari_running, automation (state plus detail), cliclick and allow_js_from_apple_events.

Any field that reads false is a gate you still need to open.

hermes safari doctor goes a step further and prints the fix for each red gate on the line below it.

Run doctor after every Safari update, because the README notes an update or a prefs reset can clear the Apple Events JavaScript setting.

A full round trip, tool by tool

The README walks through one complete loop once the first two gates are green.

  1. safari_open with a URL returns the window, tab index and URL.
  2. safari_act with action: "text" returns rendered body text, trimmed to 20k characters.
  3. safari_js evaluates a snippet and returns only the value, so you avoid pulling a whole DOM into context.
  4. safari_act with action: "find" and a CSS selector lists matches with their text before you click.
  5. safari_click in selector mode scrolls the element into view and clicks its centre.
  6. safari_type fills a field through the native value setter, so React and Vue inputs register the change, with optional submit.
  7. safari_state confirms where you ended up.

That loop covers most read, search and form tasks without screenshots.

Single-page apps: poll, do not sleep

Client-rendered pages often return an empty shell on the first read.

Get the Backlink Gameplan →

The README's advice is to poll safari_js with a check such as "return the body text if it is longer than 500 characters, else null" until it returns a value.

A single read after a fixed delay gives wrong answers on slow pages.

Build this into any skill or prompt that reads dashboards or web apps.

The error envelope

Every tool returns the same shape: {"success": true, ...} on success, or success: false with error, gate and fix fields.

Read gate and fix first; they name the exact checkbox that blocked the call.

This makes the plugin easy to wrap in a skill that tells the user which setting to flip.

Tab lifecycle

Tabs opened by safari_open close after an hour idle, at session end, or opportunistically before the next open, so a closed chat leaves nothing behind.

Pass keep: true for a tab you want to survive.

Close one immediately with safari_tabs and action: "close" plus the tab index.

Hardening the setup

Because the plugin acts in your signed-in browser without per-action approval, decide which logins it should be able to reach.

A practical approach is a separate macOS user account signed in only to the sites you want the agent to use.

Turn the Automation toggle off in System Settings when you are not running Safari tasks, and keep sensitive sites out of the session entirely.

Start with read-only tasks and only move to form filling once you trust the prompts.

Permission error codes

Two AppleEvent errors point straight at the Automation gate.

-1712 is a timeout, usually because the consent dialog was never answered.

-1743 is a denial, usually because the dialog was dismissed once and macOS will not ask again.

Fix both under System Settings, Privacy & Security, Automation, by switching Safari on for the Python or Terminal process that runs Hermes.

Screen Recording needs a restart

After you grant Screen Recording, macOS requires the process that runs Hermes to restart before screenshots work.

If safari_screenshot still fails after granting, quit and relaunch that terminal or app, then rerun hermes safari doctor.

Screenshots are the fallback read path when the JavaScript gate is off, so this step matters on locked-down machines.

Rank in AI Search or It's FREE →

Local files are in scope too

The catalog note says the agent can open any URL, including file:// paths.

That means a prompt could open and read local files through Safari, not just websites.

Keep sensitive documents out of the macOS user that runs Safari tasks, and write prompts that name the exact URLs you expect the agent to visit.

Wrapping it in a skill

Once a Safari task works by hand, turn it into a Hermes skill so the steps stay the same every run.

Spell out the URL, the safari_js snippet that returns the value, the poll condition for slow pages and the output format.

Add an explicit "do not click or submit" line for read-only skills, because the plugin will not ask before it acts.

See the Hermes docs for how skills are stored and loaded.

Version and platform checks

The catalog entry requires Hermes 0.21.0 or newer and macOS.

Confirm your Hermes version before installing, and upgrade first if you are behind.

On Linux or Windows the plugin has nothing to drive, since it relies on Safari and the macOS scripting tools.

Troubleshooting

  • -1743: Automation denied; re-enable Safari under Automation.
  • JavaScript calls return errors: re-tick Allow JavaScript from Apple Events.
  • Clicks ignored by a site: install cliclick and use coordinates.
  • Empty page text on a slow app: poll with safari_js until the text appears.

Want help with the rest of your agent stack? The AI Profit Boardroom covers it step by step.

Join the AI Profit Boardroom →

FAQ: Hermes Agent Safari

Does Hermes Agent support Safari?

Yes. Since 18 November 2026 a safari plugin in the Hermes plugin catalog drives your real Safari on macOS.

Is the Safari plugin official?

It is listed in the official Hermes plugin catalog at the community tier, maintained by Thorballer.

Which permission matters most?

Allow JavaScript from Apple Events in Safari's Develop menu. Without it the plugin can only open and list tabs.

Is it safe to use on my main Mac account?

Be careful. The catalog safety note says it acts on signed-in sites without per-action approval, so use a separate profile with limited logins.

Does it work on Windows or Linux?

No. The catalog lists macOS as the only platform.

📺 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

Install the plugin, run hermes safari doctor until all gates are green, and lock down the logins before the first real task.

For a done-with-you path, join the AI Profit Boardroom, and keep this page as your Hermes Agent Safari setup checklist.

§ Member reviews

What members say about the AI Profit Boardroom

Read the member reviews on Skool →
Ahmad Bukhari: Julian doesn't gatekeep. That's why I'd recommend this group. He's extremely active here, sharing what's working right now and jumping in to help anyone who's stuck. If he can give it away, he does. He keeps the vibe positive and pushes everyone to help each other. His challenges reward members for getting people unstuck, so the whole room shares knowledge, not just him. Want a generous, positive place to learn AI and actually use it? This is it. Thanks Julian!
Ahmad Bukhari
Julian doesn't gatekeep. That's why I'd recommend this group. He's extremely active here, sharing what's working right now and jumping in to help anyone who's stuck. If he can give it away, he does. He keeps the vibe positive and pushes everyone to help each other. His challenges reward members for getting people unstuck, so the whole room shares knowledge, not just him. Want a generous, positive place to learn AI and actually use it? This is it. Thanks Julian!

Still a paying member after 1 month

Jay Parsons: There are so many helpful members in this amazing community ready to help out with suggestions and solutions whenever someone asks a question. I am amazed at the progress I have made in learning AI. I came here to learn how to use AI better and apply what I learned to my business. I am learning so much more than I even dreamed of. I have built an Agentic OS and use it every day, and I have no background in coding. There are an incredible amount of useful tutorials on everything AI.
Jay Parsons
There are so many helpful members in this amazing community ready to help out with suggestions and solutions whenever someone asks a question. I am amazed at the progress I have made in learning AI. I came here to learn how to use AI better and apply what I learned to my business. I am learning so much more than I even dreamed of. I have built an Agentic OS and use it every day, and I have no background in coding. There are an incredible amount of useful tutorials on everything AI.

Still a paying member after 11 months

Brian O'Connor: At 47, with 30 years in sales and finance, embracing AI was exciting but overwhelming. While building a business to help others adopt AI, I found myself chasing tools and fearing I was falling behind. Julian and the AI Profit Boardroom helped me refocus through practical, personalized advice and a supportive community. I now feel more confident adapting to change while staying focused on my goals. Thank you, Julian, for bringing this community together!
Brian O'Connor
At 47, with 30 years in sales and finance, embracing AI was exciting but overwhelming. While building a business to help others adopt AI, I found myself chasing tools and fearing I was falling behind. Julian and the AI Profit Boardroom helped me refocus through practical, personalized advice and a supportive community. I now feel more confident adapting to change while staying focused on my goals. Thank you, Julian, for bringing this community together!

Still a paying member after 2 months

Neil Martin: This is a truly amazing community, thanks in no small part to Julian's prodigious output and tireless efforts to provide value to his subscribers. Nothing is too much trouble for him. If you ask a question it gets answered in short order usually with a custom video. I have been in quite a few groups and this level of service is unparalleled. If you are serious about getting an AI education, you need to be in this group!
Neil Martin
This is a truly amazing community, thanks in no small part to Julian's prodigious output and tireless efforts to provide value to his subscribers. Nothing is too much trouble for him. If you ask a question it gets answered in short order usually with a custom video. I have been in quite a few groups and this level of service is unparalleled. If you are serious about getting an AI education, you need to be in this group!

Still a paying member after 7 months

Crystal Hill: AIPB has inspired me to go beyond learning AI as individual tools, skills, and prompts, and start thinking in terms of larger systems. What I really appreciate is how responsive Julian is and how quickly the material evolves with the technology. You’re being exposed to the right tools and ideas as they emerge. AIPB has given me the confidence to learn, experiment, build, and think much bigger about what’s really possible with AI.
Crystal Hill
AIPB has inspired me to go beyond learning AI as individual tools, skills, and prompts, and start thinking in terms of larger systems. What I really appreciate is how responsive Julian is and how quickly the material evolves with the technology. You’re being exposed to the right tools and ideas as they emerge. AIPB has given me the confidence to learn, experiment, build, and think much bigger about what’s really possible with AI.

Still a paying member after 5 months

Maurice Morrison: AI Profit Board Room has been a game-changer. The insights are practical, timely, and focused on turning AI into real business results—not just theory or hype. The community is supportive, the guidance is clear, and I leave every session with ideas I can actually apply. If you’re serious about using AI to grow smarter and move faster, this is absolutely worth joining.
Maurice Morrison
AI Profit Board Room has been a game-changer. The insights are practical, timely, and focused on turning AI into real business results—not just theory or hype. The community is supportive, the guidance is clear, and I leave every session with ideas I can actually apply. If you’re serious about using AI to grow smarter and move faster, this is absolutely worth joining.

Still a paying member after 2 months

Jeremy Murdock: I have truly enjoyed my experience here. The group of folks on the calls is quite diverse and I find it comforting to know that I am not the only one going through the changes that are happening at a faster and faster pace. I have chosen to embrace the change and go full force into integrating AI and what I have learned form the group and Julian. I am also impressed and appreciative that he actually takes the time to help with challenges I have along the way and get involved personally!
Jeremy Murdock
I have truly enjoyed my experience here. The group of folks on the calls is quite diverse and I find it comforting to know that I am not the only one going through the changes that are happening at a faster and faster pace. I have chosen to embrace the change and go full force into integrating AI and what I have learned form the group and Julian. I am also impressed and appreciative that he actually takes the time to help with challenges I have along the way and get involved personally!

Still a paying member after 10 months

Michael Lovitch: I have been a part of a million ai groups in Skool for years now. They are all okay and have helped, but usually they get out of date and don't offer real service to help you through especially at the beginning. This group is different, Julian actually answers questions which is crazy! And although ai marketing moves at the speed of light, they stay current and actually help you keep up… Highly recommended!
Michael Lovitch
I have been a part of a million ai groups in Skool for years now. They are all okay and have helped, but usually they get out of date and don't offer real service to help you through especially at the beginning. This group is different, Julian actually answers questions which is crazy! And although ai marketing moves at the speed of light, they stay current and actually help you keep up… Highly recommended!

Still a paying member after 3 months

Hoebing Lo: I don't know of any other community that is as active and sharing. Julian is a star and he answers so many questions in lightning speed. If you want a great place to start with AI here it is. No question too simple. No workflow too complicated. The community is about action and results not education so if you are looking to win at AI then come for the ride of a lifetime!
Hoebing Lo
I don't know of any other community that is as active and sharing. Julian is a star and he answers so many questions in lightning speed. If you want a great place to start with AI here it is. No question too simple. No workflow too complicated. The community is about action and results not education so if you are looking to win at AI then come for the ride of a lifetime!

Still a paying member after 5 months

Darren Wagstaff: Very responsive... great personal support (not an ai chat bot). Very clear straight forward trainings in easy to understand actionable language. I'm in numerous Skool groups but this one has the most human and real community by far. No question gets ignored. You never fell like just another number. It's great to see so many members getting great results with Ai.
Darren Wagstaff
Very responsive... great personal support (not an ai chat bot). Very clear straight forward trainings in easy to understand actionable language. I'm in numerous Skool groups but this one has the most human and real community by far. No question gets ignored. You never fell like just another number. It's great to see so many members getting great results with Ai.

Still a paying member after 2 months

Rod Martin: Julian is brilliant, and more prolific than I can keep up with (which is a great thing). His AgentOS is remarkable, and he is THE go-to guy for what you can really do (and not do) with the ever-increasing deluge of new AI upgrades and tools. HIGHLY recommend.
Rod Martin
Julian is brilliant, and more prolific than I can keep up with (which is a great thing). His AgentOS is remarkable, and he is THE go-to guy for what you can really do (and not do) with the ever-increasing deluge of new AI upgrades and tools. HIGHLY recommend.

Still a paying member after 5 months

Yosuke Sato: The best Skool course you get for AI! I have attended a few Skool courses before, but AI Profit Boardroom is the most active community and has great support from the management team, including Julian! You can get the most up-to-date information and practical implementations in this community. I highly recommend this!
Yosuke Sato
The best Skool course you get for AI! I have attended a few Skool courses before, but AI Profit Boardroom is the most active community and has great support from the management team, including Julian! You can get the most up-to-date information and practical implementations in this community. I highly recommend this!

Still a paying member after 19 months

⚑ Next step

Ready to run AI agents that actually do the work?

Join 3,400+ operators inside the AI Profit Boardroom. Get 1,000+ plug-and-play AI agent workflows, 5 coaching calls a week, and a community that holds you accountable.

Join The AI Agent Community →

7-day no-questions refund · Cancel anytime

Found this useful? Get more of this site in your Google.

One tap adds us as a preferred source — Google then shows you our posts more often in Search, Top Stories, and AI Overviews.

← Back to all posts