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

Herald OS Setup: Install It + Tour Every Feature (Free)

Herald OS is a free, open-source Hermes Agent OS. Here's the install on a Mac, the first-run checks, and a walkthrough of every page and setting.

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

Herald OS is a free, open-source operating system built around Hermes Agent, so instead of clicking through menus you talk or type to Hermes and it works across your machine.

It was made by an independent developer called Luke The Dev, and it is not an official Nous Research product.

I had Claude set it up for me in about two minutes, and then I went through every single page on camera.

This post is the operator version of that video.

I'll show you what Herald OS is, how to install it on a Mac, the three checks I'd run straight after install, and then a click-by-click tour of every page and every settings area.

I'll also tell you the parts that didn't work for me, because it's an alpha and you deserve to know that before you spend an afternoon on it.

What Herald OS Is In One Minute

The project describes itself as "an agent-native operating system, with Hermes Agent as the interface".

In plain English, it's a full-screen workspace where Hermes sits in the middle of everything you do.

Hermes can open apps, find and organise files, remember what matters to you, run routines on a schedule and build software while you watch.

Every action that changes something goes through a permission system you control.

Here are the basics I checked on the GitHub repo before I wrote this.

Question Answer
Who made it? Luke The Dev (iamlukethedev on GitHub) built it as an independent project.
Is it official Hermes? It isn't, and the README says it is not affiliated with Nous Research.
What does it cost? Herald OS itself is free under the MIT licence.
What do you pay for? You pay for the model Hermes uses, unless you pick a free model.
What state is it in? It is labelled alpha (0.1), and the repo was created on 6 October 2026.
Where does it run? It runs on Apple Silicon Macs, as its own Linux OS on a PC, on Arch and Omarchy, and in a virtual machine.

Herald OS doesn't fork Hermes.

It runs your normal Hermes Agent install and adds its system abilities as a standard Hermes plugin called herald-os-bridge.

That one design choice is the reason your automations show up everywhere else you use Hermes, which I'll come back to later.

Why I Wanted Herald OS In The First Place

When I first started using Hermes around March and April this year, it lived in the terminal.

That was messy, and it scared off most of the people I showed it to.

Hermes Desktop made things better, but some people still don't like the way it looks.

Herald OS is the new way, because it gives you a beautiful interface over the same Hermes you already run.

Honestly, I think it looks nicer than Hermes Desktop, and you can personalise almost everything about it.

🔥 Want my exact Herald OS Setup setup, step by step? Inside the AI Profit Boardroom you get step-by-step video trainings, my installable Agent OS and four coaching calls a week with 3,400+ members building real automations. → Join the AI Profit Boardroom

How To Install Herald OS On A Mac

The Mac is the quickest way to try Herald OS, and it's where most of it gets built.

You need macOS 13 (Ventura) or later on Apple Silicon.

Step 1: install Hermes Agent and pick a model.

If you don't already have Hermes, the README tells you to run the official install script and then hermes setup.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc
hermes setup

Hermes needs a model provider, which can be a Nous Portal account or an API key for OpenRouter, OpenAI, Anthropic, a local model and others.

Step 2: download the app.

Grab the HeraldOS-<version>-mac-arm64.dmg file from the releases page on GitHub and drag Herald OS into Applications.

Step 3: let macOS open it.

The build isn't notarized by Apple yet, so macOS blocks it the first time.

The README's fix is one command, and you only run it once.

xattr -dr com.apple.quarantine "/Applications/Herald OS.app"

Step 4: open it and learn the two escape keys.

Herald OS takes over the whole screen when it opens.

Press Cmd+Ctrl+F to leave or re-enter fullscreen, and press Cmd+Q to quit.

On first start it adds its system tools to Hermes, and macOS asks for Screen Recording, Accessibility or Microphone access only when a feature needs it.

If you're on Linux, Arch, Omarchy or want the virtual machine, I've kept those routes short here on purpose.

The full repo walkthrough, with every install route and command, is in my Herald OS GitHub install guide.

Three Checks To Run Straight After You Install

These come straight from the README, and they take about two minutes.

First, open the Hermes page with Cmd+2 and ask it something simple.

If it asks you to sign in, use the card it shows you or run hermes setup again.

Second, ask "what is using the most memory right now?" and check that Hermes answers with its system tool rather than a shell command.

If you ask it to move a file, you should get an approval card before anything happens.

Third, if you want voice, press Alt+Space, allow the microphone, and use the "Say hello" button in Settings > Voice to test it.

If Hermes keeps using shell commands, run hermes plugins list and make sure herald-os-bridge is enabled.

🔥 Want me to walk you through your own Hermes setup? Inside the AI Profit Boardroom, I've got full Hermes Agent trainings, my Agent OS, and four coaching calls a week where 3,400+ members bring their setups and get them fixed live. → Get access here

The Herald OS Dashboard: Your Day At A Glance

The first screen is the Overview, and mine greeted me with "Good morning, Julian. Your day already in motion."

You can talk to it with voice input straight from that screen.

It shows today's schedule, which it builds from your scheduled tasks.

There's a "here's what needs attention" panel that pulls the urgent bits to the top.

The smartest part is "Pick up where you left off".

Hermes looks at the names of your recent documents, projects, chats and calendar events, then suggests where you should continue.

The README says it puts up to three threads of work on the Overview, and a suggested next step only starts when you click it.

It's off until you switch it on, and it reads names and dates rather than file contents.

It also surfaced recent screenshots from my desktop, which is handy if you screenshot as much as I do.

Below all that you get a normal Hermes chat with Preview and Sources, where you can add files Hermes can read, and a button for a new conversation.

Spaces: How To Split Clients And Companies

This is the feature that answers a question I get all the time inside the Boardroom.

People ask, "I have separate companies or clients, so how should I set up my agent OS?"

Herald OS ships with three spaces called Ideas, Work and Personal.

You can add new spaces, such as one for each client, and keep their work apart.

There's also a default space setting, so Herald OS always opens where you spend most of your day.

Missions: Hand Hermes A Goal, Not A Prompt

Missions is the page where you give Hermes an active goal.

The page tagline is "From intent to finished work", and the input box asks, "What should Hermes accomplish?"

My example was "build out a new website".

Hermes plans it step by step, and each mission shows its plan, a preview of the files it writes, and an activity timeline.

The difference from a normal chat is that a mission keeps going until the job is done, and you can check in on it any time.

Memory: See Everything Hermes Remembers

The Memory page shows everything Hermes remembers about you, with search and a way to add or forget memories yourself.

When I opened mine on camera, I spotted my Telegram details sitting right there.

So here's the warning I'll give every operator.

Check your Memory page before you screen-share Herald OS, because it can show personal details you forgot you ever gave it.

Files: A Finder That Hermes Can Use

The Files page has recent files, favourites, projects, downloads, shared and deleted.

You can search by name or simply describe what you need.

Hermes can move and rename files for you, but those actions ask first.

The FAQ in the repo says Herald OS never deletes permanently, and moving to the Trash asks every single time.

Automations: Set Them Once And They Sync Everywhere

The Automations page lists your scheduled routines, and you can switch each one on or off.

You can run one now, duplicate it, or make a new one, and every automation shows its recent runs.

Here are the ones I had running.

  • I get a daily 6am to-do recap.
  • I get a daily Japanese learning session.
  • I get inbox triage with a morning inbox summary.

Here's the part that impressed me most.

My automations synced across Herald OS, Hermes Desktop and my own Agent OS, because all three run the same Hermes underneath.

You don't rebuild anything when you switch interfaces.

The manual also says automations can fire on events, such as when you log in, come back after a break, the battery runs low or a program crashes.

🚀 Ready to put Herald OS Setup to work in your business? Inside the AI Profit Boardroom you get step-by-step video trainings, my installable Agent OS and four coaching calls a week with 3,400+ members building real automations. → Join the AI Profit Boardroom

Connections: The Part That Didn't Work For Me

Connections is meant to bring your tools, apps and external services into one workspace.

I'll be straight with you, though, because it didn't connect or sync for me.

That's the trade-off with a two-day-old open-source alpha, and there will be some back-and-forth before it's solid.

You could ask Claude to fix it for you, which is how I'd approach it if I needed it today.

The sidebar is resizable, and the UI was cut off slightly at the top on my screen, which is another rough edge I'd expect to get fixed.

Every Herald OS Settings Area, Explained

Settings is where Herald OS really earns its "operating system" name, so here's the full walkthrough.

Settings area What you can do there
Hermes & agents You choose the preferred model, where agents run tasks (including Docker), the number of background agents, and whether Hermes remembers your preferences.
Autonomy and approvals You pick Ask first, Balanced or Independent, and you can turn "Ask before sending messages" on or off.
Activity history You can see background work you set up and forgot about.
General You set launch fullscreen, default space, default folder, projects folder, do not disturb, stay awake, screensaver, dictation and quit session.
Appearance You change colours and themes, and the README lists twelve themes, two of them light.
Software You add or remove coding agents and local model apps such as Claude Code, Codex and LM Studio.
Plugins You paste a GitHub link to add a widget plugin, or ask Hermes to make one.
Usage You see tokens used this week and over 30 days, your plan and your balance.
Voice You switch the voice engine, speed and provider, test it, and see the voice commands.
Privacy, notifications, network, storage, accessibility You get the audit log, the bell sound, and the usual system controls.

On my machine, the preferred model showed GPT-6 Astra, which I had plugged in through a CLI.

The do not disturb switch matters, because there's a bell notification sound that gets old fast.

Plugins install turned off, so you see what a plugin asks for before it runs, and each one runs in a sandbox.

Usage is useful if you're paying for a model, because the README says it warns you at 90% of your plan.

The voice settings let you choose a local voice or the "live" voice, test it, and read a list of voice commands, which makes it feel very Jarvis-like.

The repo docs say the free voice engine replies in about two seconds, while the optional Live engine uses OpenAI's gpt-live-1 at $0.05 a minute with your own OpenAI key.

Herald OS vs Hermes Desktop For Operators

Both run the same Hermes, so your brain, memory and automations carry across.

What matters Herald OS Hermes Desktop
Look and feel It's a full-screen OS with a dashboard, and I think it's the nicer design. It's a normal desktop app window.
Who makes it An independent developer makes it. It's the dedicated Hermes desktop app I've covered before.
Maturity It's an alpha with rough edges. It's the more settled option.
Plugins It takes widget plugins from a GitHub link. It has the one-click plugin marketplace with around 500 community plugins.
Best for It suits people who want a beautiful UI and don't like Hermes Desktop. It suits people who want stability today.

If you want the plugin side, I covered it in my Hermes Agent plugins marketplace guide.

🔥 Want the Hermes trainings and the Agent OS I use every day? The AI Profit Boardroom has step-by-step Hermes courses, my automation blueprints and weekly coaching calls with 3,400+ members. → Join the AI Profit Boardroom

Herald OS Tips And Limits Before You Rely On It

  • Keep backups of anything you let an agent touch, because the README itself says to do that during the alpha.
  • Leave autonomy on Ask first until you've watched Hermes work for a few days.
  • Check the Memory page before you record or share your screen.
  • Expect Connections to be unreliable for now, and don't build a client workflow on it yet.
  • Remember the Mac build isn't notarized, so only download it from the official releases page.
  • Remember Herald OS is free, but your model provider can still bill you, so watch the Usage page.

If you want to run it without paying for a model at all, my free Hermes Agent OS breakdown covers the free model routes.

My Verdict On Herald OS

Herald OS is super clean, it synced with my existing Hermes setup almost instantly, and it's genuinely nice to use.

It's a great fit if you want a beautiful UI for Hermes and you don't like Hermes Desktop.

It's not a fit yet if you need every connection working perfectly, because it's an alpha.

My advice is to install it on a Mac, run the three checks, set up one space and one automation, and see how it feels after a week.

Related Reading

FAQ: Herald OS

What is Herald OS?

Herald OS is a free, open-source, agent-native operating system that uses Hermes Agent as the interface.

It was made by the independent developer Luke The Dev and is not an official Nous Research product.

Is Herald OS free?

Herald OS is free and MIT-licensed.

The model Hermes uses is billed by its provider, unless you choose a free model, and the Usage page shows what you've used.

How do I install Herald OS on a Mac?

Install Hermes Agent and run hermes setup, download the Herald OS DMG from the GitHub releases page, drag it to Applications, and run the xattr command once because the build isn't notarized yet.

You need macOS 13 or later on Apple Silicon.

Does Herald OS replace Hermes Desktop?

It doesn't have to, because both run the same Hermes install.

My automations synced across Herald OS, Hermes Desktop and my Agent OS, so you can use whichever interface you prefer.

Is Herald OS safe to use?

Actions that change something ask first, destructive actions ask every time, and folders like ~/.ssh are always refused.

It is still an alpha, so keep backups and leave autonomy on Ask first while you learn it.

Why aren't my Herald OS connections working?

Connections didn't connect or sync for me either, which is a known rough edge of an early alpha.

You can wait for updates, report it on GitHub, or ask Claude to help you fix it.

📺 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 agency, Goldie Agency, with a team of around 50 people.
  • I've grown a YouTube channel to 400,000+ subscribers.
  • I wrote the Amazon best-sellers "SEO Link Building Mastery" and "Agency Marketing Mastery".
  • My Udemy courses have taught over 50,000 students.

→ Get my best AI training inside the AI Profit Boardroom

Install it, run the three checks, and you'll have the cleanest Hermes interface I've tested running inside Herald OS.

§ 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