Get started
From download to notch.
Herm is a native client for the Hermes Agent already installed on your Mac. It shares the same sessions and profiles, so Hermes Desktop and the CLI keep working beside it. Download the app, or build it from source.
Before you begin
- macOS 14 or later. Built and tested on Apple Silicon.
- Hermes Agent installed, with
hermesavailable on your PATH. - Optional: GitHub CLI, signed in, for pull requests and issues.
Download
- Open
Herm.dmgand drag Herm to Applications. - Open Herm. The first time, macOS blocks it because the build is not notarized.
- Go to System Settings → Privacy & Security, choose Open Anyway, and confirm.
Stable releases are tested builds. The nightly is rebuilt from every green change on main and has the newest features first.
Build from source
Needs the Swift 6 toolchain (Xcode 16 or later).
git clone https://github.com/chryzxc/herm.git
cd herm
swift runTo build and open the signed debug bundle with its icon:
Scripts/run-debug-app.shFind the notch on the edge of your screen. Hover for a preview, click to open, or double-tap ⌘.
A few things to know
Herm supports a subset of Hermes capabilities. Each feature turns on only when the installed runtime supports it. It is not a replacement for the Hermes CLI or the official Desktop app.
Capabilities not yet available
Directly invoking arbitrary third-party MCP tools; structured cron report contracts and deeper diagnostics; provider-independent full-duplex realtime audio; email and iMessage integrations; and writing to Calendar or Reminders. Calendar is read-only. Project management, group chats, bot @mention autocomplete, and remote gateway options are available when supported by the installed runtime.
GitHub actions intentionally left out
Pull-request comments, reviews, and confirmed merge actions are available. Force-pushing, dispatching workflows, native conflict editing, and arbitrary Projects custom-field editing are not supported. Repository permissions and merge rules still apply.
Signing and updates
Release DMGs are ad-hoc signed and not notarized, so Gatekeeper warns on first launch. Herm checks GitHub Releases for new versions and shows them in Settings → Updates; ad-hoc builds are updated by downloading the new DMG.
Questions
What do live simulator previews need?
The installed app needs Herm’s local simulator bridge plus a compatible full Xcode installation and idb companion for iOS, or Android SDK Emulator for Android. Start a device from chat, then open its preview tab. This website only switches offline captures; it does not launch or connect a device.
Does Herm run models itself?
No. Herm connects to your local Hermes runtime. Hermes handles model providers, tools and sessions.
Does everything stay on my Mac?
Local mode uses an authenticated loopback gateway. Remote, SSH, and Cloud modes use the backend you configure. Herm has no telemetry. Hermes may send prompts, files, or tool data to configured providers and services; local-first does not mean offline.
What about credentials?
Provider keys for OpenCode Go and GLM quota are saved in a local config file readable only by your user account. Antigravity quota is read from its local language server without credentials. See the app README for the current privacy details.
Does it update Hermes automatically?
No. You must confirm before it runs hermes update. Settings shows streamed logs and elapsed time.
Is this the official Hermes Desktop app?
No. Herm is an unofficial, MIT-licensed community project, separate from the official Hermes Agent Desktop app.