Skip to content
Alan Wizemann edited this page Sep 22, 2026 · 48 revisions

Scarf

The native Mac & iOS app for the Hermes AI agent. Full visibility into what Hermes is doing, when, and what it creates — on your Mac against one local install or many remote ones, and from your iPhone over SSH with ScarfGo.

Latest release: v3.3.0Scarf gets a voice. A two-way voice conversation with Hermes on the Mac and in ScarfGo, following the host's own voice.voice_chat_mode: chained (Hermes's default) is free, on-device speech-to-text with the reply read aloud by the host's TTS provider or the system voice (Hermes v0.20.1+), and GPT-Live uses OpenAI's real-time voice model on the host's key (Hermes v0.21.3+, one-time privacy consent per device, running cost shown). Every request is still a normal Hermes turn. Plus Hermes Voice playback (replies spoken by the server's configured TTS provider), ScarfGo dictation (on-device only; thanks to @danmarauda for PR #143), honest session costs (an unknown cost is a dash, not "$0.00"), chat windows that stop hermes acp when closed, a Kanban badge that no longer leaks counts between chats, and ScarfGo reassembling multi-byte text correctly across SSH packets. Previous: v3.2.0Hermes v0.21.2 and the largest correctness pass yet: every v0.21.1 surface a Mac client can use, all capability-gated; six rounds of adversarial audit fixed settings that showed the wrong value, buttons that reported success over a refusal, twelve wrong capability floors, and blocking work on the main actor; a real UI release gate (Smoke/Full/Live XCUITest plans). Earlier: v3.1.0 — projects grow up: four rounds of adversarial auditing on the projects surface, atomic writes on every transport, a Project Doctor, signed mini-app grants, a redesigned sidebar and per-project auto-accept edits. All earlier versions: Release Notes Index.

Mobile: Download ScarfGo on the App Store — free. Prefer beta builds? Join the public TestFlight. See ScarfGo for the feature tour and ScarfGo Onboarding for the one-minute SSH setup.

Targets Hermes: v0.21.2 (v2026.9.11), with the voice surfaces gated on their own floors — Hermes Voice playback and chained voice conversation on v0.20.1+, GPT-Live on v0.21.3 (v2026.9.14). Everything newer than a host's version is capability-gated or schema-detected — Hermes v0.6.0 through v0.21.3 hosts keep working exactly as before, with newer-only surfaces hidden gracefully. History: Hermes Version Compatibility.

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

What Scarf does

Scarf mirrors Hermes's surface area through a sidebar UI, with Projects first — selecting a project opens a unified cockpit (Dashboard, Sessions, Board, Site, Context, Cron, Memory, Secrets, Templates, Slash, Mini-apps, Fleet):

  • Projects — cockpit, agent-generated dashboards, Kanban, mini-apps, fleet drift + apply.
  • Monitor — Dashboard, Insights, Sessions, Activity. See what Hermes is doing.
  • Interact — Chat (ACP rich chat + real terminal), Memory, Curator, Skills.
  • Configure — Platforms, Personalities, Quick Commands, Credential Pools, Plugins, Webhooks, Profiles, Models, Hermes Proxy.
  • Manage — Tools, MCP Servers, Messaging Gateway, Cron, Health, Logs, Settings.

Capability-gated sections (Kanban, Curator, Models, Proxy, and many settings) appear only when the connected host's Hermes version supports them.

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), actively maintained. See Roadmap for what's coming.


Last updated: 2026-09-22 — Scarf 3.3.0 (voice conversation in chained and GPT-Live modes, Hermes Voice playback, ScarfGo dictation, honest session costs).

Clone this wiki locally