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.8.0 — coordinated catch-up to Hermes v0.13.0, "The Tenacity Release". Ships Persistent Goals (/goal <text> slash command + chat-header pill that survives across turns), ACP /queue (queue prompts to run after the current turn, with a header chip + popover preview), Kanban v0.13 diagnostics + recovery UX (worker-created cards land with a hallucination gate + Verify/Reject buttons; per-task max_retries; auto-block reasons surfaced verbatim; multiline title input), Curator archive + prune (Archived section with destructive-prune confirm sheet matching the template-uninstall pattern; synchronous "Run Now" with progress affordance), Google Chat as the 20th gateway platform + cross-platform allowlists (allowed_channels/allowed_chats/allowed_rooms per platform) with busy_ack_enabled + restart-notification toggles + slash-command auto-delete TTL, a refreshed provider catalog (5 new models: deepseek-v4-pro, grok-4.3, owl-alpha, hy3-preview, arcee/trinity-large-thinking; grok-4.20-beta → grok-4.20 alias-resolved at read time; Vercel demoted), image_gen.model honored in Settings → Auxiliary, OpenRouter response caching toggle, MCP SSE transport, Cron --no-agent watchdog mode, per-capability Web Tools backends (search vs extract split), Profiles --no-skills, context compression count chip in chat status bar, /new <name> slash argument, display.language picker (zh/ja/de/es/fr/uk/tr), xAI Custom Voices badge, plus iOS read-only catch-up for Goals/Kanban diagnostics/Curator archived/Platforms allowlists/v0.13 features-active badge. Two dogfood-discovered fixes ride along: dashboard flicker on v0.13 (file-watcher coalescing + max-wait safeguard + dashboard load dedupe) and sparse slash menu on resumed sessions (preserve acpCommands across reset() + active-session static fallback). 22 new capability flags gate every surface; pre-v0.13 hosts render the v2.7.5 layout byte-identical. See v2.8.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.13.0 (v2026.5.7) — Persistent Goals, ACP /queue, Kanban hallucination gate + diagnostics engine, Curator archive/prune + sync run, Google Chat (20th platform), cross-platform allowlists, MCP SSE transport, Cron --no-agent, Web Tools per-capability backends, Profiles --no-skills, display.language, xAI Custom Voices. 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.13-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-08 — Scarf v2.7.5 (Kanban v3: drag-and-drop board, per-project tenants, inline assignee picker + auto-dispatch, worker log streaming, iOS read-only board, kanban_summary widget, sidebar Manage → Monitor; LocalTransport PATH enrichment fixes spawn_failed in GUI-launched Scarf)

Getting Started

ScarfGo (iOS)

User Guide

Architecture

Developer Guide

Reference

Troubleshooting

Slow Chat Startup

Contributing

Release History

Legal & Support

Wiki edited via the local .wiki-worktree/ clone. See Wiki Maintenance for the workflow. Last sync: 2026-04-20.