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.9.0 — coordinated catch-up to Hermes v0.14.0, "The Foundation Release". Ships /subgoal + /yolo + /sessions + /codex-runtime ACP slash commands (subgoals layer extra success criteria onto an active /goal loop with a +N count badge inside the goal pill; the YOLO chip warns when dangerous-command auto-approval is on), two new inference providers (xAI Grok OAuth / SuperGrok as a subscription-gated overlay + NovitaAI as an API-key overlay; Alibaba → Qwen Cloud display rename mirrors Hermes's picker without changing the wire ID), two new gateway platforms (LINE Messaging API as the 21st platform, SimpleX Chat as the 22nd talking to a local simplex-chat daemon over WebSocket), two new web-search backends (Brave Search free tier + DuckDuckGo via DDGS), Hermes Proxy as a new Configure → Hermes Proxy sidebar destination wrapping hermes proxy start to give Codex / Aider / Cline / VS Code Continue an OpenAI-compatible local endpoint that attaches your authenticated upstream credentials, MCP supports_parallel_tool_calls as a tri-state picker in the server editor, ACP --setup-browser as a one-click chromium + playwright provisioning button on the Health view, plus a stack of smaller settings (terminal.docker_extra_args, display.timestamps, Cron deliver=all, Discord channel-history backfill, plugin tool_override manifest badge) and the bundled performance + reliability fixes since v2.8 (per-project model presets + mid-chat switcher via session/set_model, Kanban toolset enable YAML write fix, MetricKit crash + hang diagnostics on iOS, JSON read caps in session-attribution + project-dashboard, scroll crash + background-lifecycle hardening, selectable text across paragraphs, process pipe draining for large Kanban output, transcript render perf, iOS slash-command parity, /steer honesty pre-session). 24 new capability flags gate every v0.14 surface; pre-v0.14 hosts render the v2.8.0 layout byte-identical. See v2.9.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.14.0 (v2026.5.16) — /subgoal / /yolo / /sessions / /codex-runtime ACP slash commands, xAI Grok OAuth + NovitaAI providers, LINE + SimpleX Chat platforms, Brave Search + DuckDuckGo web-search backends, Hermes Proxy local server, ACP --setup-browser, YOLO mode warning, Alibaba → Qwen Cloud display rename, MCP supports_parallel_tool_calls, terminal.docker_extra_args, display.timestamps, Cron deliver=all, Discord channel-history backfill, plugin tool_override badge. v0.13.0 / v0.12.0 / v0.11.0 / v0.10.0 still work for everything that didn't change — Scarf detects the host's Hermes version and hides v0.14-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+)
• Hermes Proxy — OpenAI-compatible local server for Codex / Aider / Cline / VS Code Continue (v2.9+, Hermes v0.14+)
• 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-16 — Scarf v2.9.0 (Hermes v0.14 catch-up: /subgoal + /yolo + /sessions + /codex-runtime ACP slash commands, xAI Grok OAuth + NovitaAI providers, LINE + SimpleX Chat platforms, Brave Search + DuckDuckGo web-search backends, Hermes Proxy local server, ACP --setup-browser, YOLO mode warning, Alibaba → Qwen Cloud display rename, MCP supports_parallel_tool_calls, docker_extra_args / display.timestamps / Cron deliver=all / Discord backfill / plugin tool_override badge)