An agent-native operating system, with Hermes Agent as the interface. Independent project, not affiliated with Nous Research.
Requires a passing catalog security scan.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
# Add to your Claude Code skills
git clone https://github.com/iamlukethedev/Herald-OSGuides for using ai agents skills like Herald-OS.
Last scanned: 10/8/2026
{
"issues": [
{
"type": "npm-audit",
"message": "@electron/get: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "app-builder-lib: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "dmg-builder: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "electron-builder: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "electron-builder-squirrel-windows: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "global-agent: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "http-cache-semantics: http-cache-semantics max-stale handling can disclose cross-user cached responses",
"severity": "high"
},
{
"type": "npm-audit",
"message": "roarr: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "sprintf-js: sprintf-js vulnerable to denial of service through unbounded precision specifiers",
"severity": "medium"
},
{
"file": "README.md",
"line": 61,
"type": "remote-install",
"message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash\"",
"severity": "low"
}
],
"status": "WARNING",
"scannedAt": "2026-10-08T11:10:05.557Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how Herald-OS compares with popular alternatives.

Herald OS is an operating system built around an AI agent. Instead of working through menus and folders yourself, you talk or type to Hermes, and it works across the whole machine: it opens apps, finds and organises files, watches what is running, remembers what matters to you, runs routines on a schedule, and builds software while you watch. Every action that changes something goes through a permission system you control.
[!NOTE] Herald OS is an independent project by Luke The Dev. It is not an official Hermes or Nous Research product, and it is not affiliated with, sponsored by or endorsed by Nous Research. Herald OS runs on Hermes Agent, the open-source agent Nous Research publishes, which is installed alongside it.
Status: alpha (0.1). Expect rough edges, and keep backups of anything you let an agent touch.
Every download is on the releases page. Pick the way that matches your machine:
| Your machine | What to install |
|---|---|
| A Mac, Apple Silicon or Intel | Herald OS for macOS (Intel: not yet available) |
| A PC you can give to Herald OS | The Herald OS Linux installer |
| Arch Linux | The Arch package |
| Omarchy | The Arch package, then one command |
| Another Linux | The tarball |
| An Apple Silicon Mac, to try the whole OS | The virtual machine from the terminal, or in UTM (not yet available) |
| An Intel Mac, to try the whole OS | The x86_64 virtual machine (not yet available) |
| A Windows 11 PC, to try the whole OS | The virtual machine in Hyper-V (not yet available) |
Hermes needs a model provider whichever you pick: a Nous Portal account, or an API key for a provider Hermes supports (OpenRouter, OpenAI, Anthropic, a local model, and others). Herald OS shows a sign-in card the first time Hermes needs one, and Settings > Hermes & agents > Model provider switches to another provider or takes its API key, a custom endpoint's included.
You need macOS 13 (Ventura) or later, on Apple Silicon or Intel (On an Intel Mac).
1. Install Hermes Agent and choose a model, if you don't have it yet:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc
hermes setup
2. Install Herald OS. Download HeraldOS-<version>-mac-arm64.dmg (Apple Silicon) or
HeraldOS-<version>-mac-x64.dmg (Intel, not yet available: see
On an Intel Mac) from the
releases page, open it and drag Herald OS to
Applications. Apple menu > About This Mac says which you have: "Chip: Apple M…" is Apple Silicon,
"Processor: … Intel …" is Intel.
3. Let it open. This build is not notarized by Apple yet, so macOS stops it the first time. Run this once, then open Herald OS from Applications:
xattr -dr com.apple.quarantine "/Applications/Herald OS.app"
Or, without Terminal: open Herald OS once and close the warning, then go to System Settings > Privacy & Security, scroll to Security, click Open Anyway next to "Herald OS was blocked", and confirm with your password. Since macOS Sequoia, right-click > Open no longer skips the warning.
Herald OS takes over the screen: Cmd+Ctrl+F leaves or re-enters fullscreen and Cmd+Q quits. On
its first start it adds its system tools to Hermes (~/.hermes/plugins/herald-os-bridge). macOS asks
for each of these the first time a feature needs it:
192.168… address. Hermes runs inside Herald OS, so this is Herald OS's to
allow.Not yet available. No release has published the Intel build yet, so these steps are for when one does. Until then, the x86_64 installer ISO below runs the whole OS in a virtual machine.
Download HeraldOS-<version>-mac-x64.dmg and follow the steps above. The Intel build is the same
app built for x86_64, with node-pty's Intel binaries for the Terminal, but it is new and has not
been tried on an Intel Mac yet: please open an issue
if something does not work.
To try the whole OS instead, open the ready-made x86_64 disk in UTM, as in On Linux or an Intel Mac, once a release has it (not yet, #186), or install the x86_64 installer ISO from Herald OS Linux on a PC in a VM that boots with UEFI. CI installs it in QEMU with UEFI, 4 cores, 6 GB of memory and a 40 GB disk (installer-test.yml).
The whole operating system, for a 64-bit Intel or AMD PC: Fedora underneath, everything you see is Herald.
Download both parts of the installer from the
releases page,
herald-os-<version>-x86_64.iso.part0 and .part1 (GitHub takes files of up to 2 GB), and join
them. On macOS or Linux:
cat herald-os-<version>-x86_64.iso.part* > herald-os-<version>-x86_64.iso
shasum -a 256 -c herald-os-<version>-x86_64.iso.sha256 # sha256sum -c on Linux
Releases after 0.1.0-alpha.4 will also have a .sha256sums with a line per part:
shasum -a 256 -c herald-os-<version>-x86_64.iso.sha256sums before joining shows which part to
fetch again after a bad download.
On Windows: copy /b herald-os-<version>-x86_64.iso.part0 + herald-os-<version>-x86_64.iso.part1 herald-os-<version>-x86_64.iso.
Write the ISO to a USB stick of 8 GB or more with Fedora Media Writer or balenaEtcher.
Start the PC from the stick and follow the installer. Its disk screen lets you erase the disk or
install next to Windows, and encrypts it unless you untick "Encrypt my data". The disk password
is typed at every start, before Bluetooth is up, so use a wired keyboard or one with a 2.4 GHz
receiver for it; herald-os password --disk changes it later. Secure Boot can stay on.
The first start sets up Hermes Agent, then Herald OS asks for your name, a password and Wi-Fi.
Updates come as a whole new version of the system: herald-os update installs one, and
herald-os rollback goes back to the one before. Already on Fedora Silverblue or another bootc
system? It can switch to the Herald OS image in place, which replaces the system you run: try it on
a spare machine or in a virtual machine. Afterwards a login screen asks who signs in, and your own
account and its password keep working. Herald OS also adds a hermes account, which stays locked,
and is not an administrator, until you give it a password (sudo passwd hermes).
docs/LINUX.md has the steps, what changes and
how to go back.
git clone https://github.com/iamlukethedev/Herald-OS.git
cd Herald-OS/packaging/arch/herald-os-bin
makepkg -si
herald-os setup # once per user: Hermes Agent and Herald's system tools
The package downloads the release build for your architecture (x86_64 or aarch64). Then choose
Herald OS on your login screen for the full session (it needs niri; the package's optional
dependencies list what each pane
Herald-OS is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by iamlukethedev. An agent-native operating system, with Hermes Agent as the interface. Independent project, not affiliated with Nous Research. It has 663 GitHub stars.
Herald-OS returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.
Clone the repository with "git clone https://github.com/iamlukethedev/Herald-OS" and add it to your Claude Code skills directory (see the Installation section above).
Herald-OS is primarily written in TypeScript. It is open-source under iamlukethedev on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh Herald-OS against similar tools.
No comments yet. Be the first to share your thoughts!