Home

Scarf

A native macOS companion app for the Hermes AI agent. Full visibility into what Hermes is doing, when, and what it creates — across one local install or many remote ones.

Latest release: v2.5.0 — ScarfGo iOS companion + ScarfDesign overhaul + Hermes v0.11 chat parity. Patched in v2.5.1 (Mac chat performance, Hermes v0.11 profile awareness, iOS keyboard dismissal, opt-in iCloud Keychain sync, chat density preferences — see release notes). Latest mobile: Join the public TestFlight. The link is live now but only accepts new beta testers once Apple's Beta Review approves the first build — see ScarfGo for the full feature tour. Targets Hermes: v0.11.0 (v2026.4.23) — /steer, new state.db columns, design-md/spotify skills, SKILL.md frontmatter chips. v0.10.0 still works for everything that didn't change. Available in: English, Simplified Chinese (zh-Hans), German (de), French (fr), Spanish (es), Japanese (ja), Brazilian Portuguese (pt-BR). See Localization. ScarfGo is English-only in v1.

Quick links

• Installation — download, first launch, system requirements (Mac)
• ScarfGo — the iPhone companion (public TestFlight from v2.5)
• ScarfGo Onboarding — SSH keys, paste-public-key, connection test
• Platform Differences — Mac vs iOS feature matrix
• First Run — what Scarf expects in ~/.hermes/
• Project Templates — .scarftemplate bundles, install / export / author
• Slash Commands — author project-scoped slash commands (v2.5+)
• Design System — ScarfColor / ScarfFont / components reference
• Architecture Overview — MVVM-F, services, transport, ScarfCore
• Servers & Remote — adding remote Hermes hosts over SSH
• Localization — supported languages + how to contribute a new one
• Release Notes Index — every version's notes
• Privacy Policy · Support — what data the apps access; how to get help
• Wiki Maintenance — how this wiki is edited and kept in sync

What Scarf does

Scarf mirrors Hermes's surface area through a sidebar-based UI grouped into four sections:

• Monitor — Dashboard, Insights, Sessions, Activity. See what Hermes is doing.
• Interact — Chat, Memory, Skills. Talk to Hermes and shape what it knows.
• Configure — Platforms, Personalities, Quick Commands, Credential Pools, Plugins, Webhooks, Profiles, Servers. Set Hermes up.
• Manage — Tools, MCP Servers, Gateway, Cron, Health, Logs, Settings. Operate Hermes.

Scarf 2.0 is a multi-window app — one window per Hermes server, local or remote. Remote hosts are reached over plain SSH using your existing ~/.ssh/config, agent, ProxyJump, and ControlMaster.

Project status

Open-source (MIT), 160+ stars, actively maintained. See Roadmap for what's coming.

---

Last updated: 2026-04-27 — Scarf v2.5.1 patch (Mac + iOS bugfixes + chat density + iCloud Keychain sync)