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.6.0 — catches up to Hermes v2026.4.30 (v0.12.0) with the autonomous Curator (Mac sidebar + iOS panel), multimodal image input in chat (Mac drag/drop + paste, iOS PhotosPicker), 5 new inference providers (GMI Cloud, Azure AI Foundry, LM Studio first-class, MiniMax OAuth, Tencent TokenHub), Microsoft Teams + Yuanbao gateway platforms, a read-only Kanban, Skills v0.12 surface (URL install / reload / OFF pill / curator pin badge), cron --workdir, Settings deltas (cache TTL, redaction toggle, runtime metadata footer, Piper TTS, Vercel terminal), and ScarfGo read-only Webhooks / Plugins / Profiles. Every new surface is capability-gated — v0.11 hosts see the v2.5.2 surface unchanged. Plus a chat post-merge bug-fix round: typing lag (#67), font-size slider scaling (#68), placeholder ghosting (#65), per-session draft scoping (#62), sent-message blank after nav (#63), background completion notifications (#64), per-message TTS (#66), ACP control-message timeout 30s→60s (#61). See v2.6.0 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.12.0 (v2026.4.30) — autonomous Curator, multimodal ACP image content blocks, 5 new providers, Microsoft Teams + Yuanbao gateways, Kanban CLI, Skills URL install / reload / disable, cron --workdir, auxiliary.curator, prompt-cache TTL, Piper TTS, Vercel terminal. v0.11.0 / v0.10.0 still work for everything that didn't change — Scarf detects the host's Hermes version and hides v0.12-only surfaces gracefully. 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
• Performance Monitoring — ScarfMon: opt-in perf instrumentation, how to capture a baseline
• 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-05-01 — Scarf v2.6.0 (Hermes v0.12 catch-up: Curator, multimodal images, 5 new providers, Kanban, Skills v0.12 surface, ScarfGo Webhooks/Plugins/Profiles, post-merge chat bug fixes)