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.10.2 — small bug-fix release. Headline fix: ACP permission prompts ("Allow Once" / "Allow For Session") now actually work — Mac + iOS were sending the pre-spec {kind: "allowed"} outcome to Hermes's session/request_permission, which Hermes correctly read as a cancellation, so every Allow tap was treated as a dismissal. v2.10.2 sends the Zed-spec {outcome: {outcome: "selected", optionId: …}} shape and pins it under a JSON-decoding test. Also extends Scarf's verified-Hermes-compatibility range to v0.15.2 (released 2026-05-29) — v0.15.1's hotfix wave (dashboard 401 reload fix, Docker --insecure opt-in, MCP bare-command resolution under Docker, Kanban worker SIGTERM, full skills.sh catalog restored, /yolo mid-session, /model parity) and v0.15.2's packaging fix are transparently back-compat. See v2.10.2 release notes. Sparkle update note for v2.10.2: see Troubleshooting: Update "improperly signed" if you hit a signing error — fully resolved 2026-06-06.

Previous release: v2.10.1 — a "projects fundamentals" maintenance release on top of v2.10.0. Ships six bundled /scarf-* slash commands (/scarf-new, /scarf-help, /scarf-dashboard, /scarf-widget, /scarf-cron, /scarf-export) loaded into the chat menu in every chat (pre-session, global, project-scoped) and installed to ~/.hermes/scarf/slash-commands/ by a new SlashCommandBootstrapService with the same version-gated upgrade pattern as bundled skills, fixes the Skills sidebar so the bundled scarf-template-author finally shows up (SkillBootstrapService now installs under a scarf/ category subdir matching SkillsScanner's <category>/<skill>/SKILL.md layout, with a one-time auto-migration of the old flat install), makes the pre-session slash menu honest (the full agent-command set stays in the menu greyed-out with a "Available once a chat is open" tooltip instead of collapsing to just /new), rewrites the New-project wizard hand-off (kickoff prompt now uses SKILL: / PROJECT_PATH: anchors agents reliably treat as invocation markers + a SkillBootstrapService preflight in commit() so the bundled skill is on disk before session/new), extends the AGENTS.md scarf-project block with a static "Scarf platform reference" section (dashboard widget vocabulary, project slash commands, Kanban tenant convention, model presets, typed config with Keychain-backed secrets, cron --workdir, skill loading, template export) — idempotent + secret-safe + capped to ~30 lines + now refreshed on template install too, and adds a Health capabilities diagnostic panel (raw hermes --version line, parsed semver/date, per-release flag list, Re-detect button) with auto-refresh on NSApplication.didBecomeActive so hermes update outside Scarf is picked up without a relaunch. Targets Hermes v0.15.0 unchanged. See v2.10.1 release notes.

Earlier release: v2.10.0 — coordinated catch-up to Hermes v0.15.0, "The Velocity Release". Ships OpenAI as a first-class provider (wire ID openai-api, distinct from OpenAI Codex; bare openai stays a Hermes alias to OpenRouter so it's intentionally not registered), Krea image-gen models (krea-2-medium / krea-2-large) + the xAI May-15 model-retirement aliases (retired Grok IDs and grok-imagine-image-pro resolve forward; Vercel AI Gateway + Vercel Sandbox dropped, deleted upstream), xAI Web Search as a web_tools.search.backend: xai option, ntfy as the 23rd gateway platform (push notifications via a topic URL, no account) plus per-platform flags (Telegram disable_topic_auto_rename / ignore_root_dm, Discord allow_any_attachment, Signal group-only require_mention), the xAI TTS auto_speech_tags opt-in toggle, the Kanban v0.15 maturation wave (server-side --sort; Promote / Schedule / Delete-permanently card actions; new Scheduled + Review columns; per-task worktree --branch + read-only model_override in the inspector; a precise chat-scoped board keyed by the originating ACP session_id with a "This chat ⇄ All tasks" scope toggle; --board multi-board plumbing in the service layer), Bitwarden Secrets Manager as a new Settings → Secrets tab (secrets.bitwarden.*), MCP mTLS client certs (client_cert / client_key / ssl_verify) + a read-only hermes mcp catalog browse sheet, a read-only skill Bundles tab over ~/.hermes/skill-bundles/*.yaml, per-session edit-approval modes via a chat-header chip (Default / Accept Edits / Don't Ask through ACP session/set_mode), and a Health "Run supply-chain audit" button (hermes audit, OSV.dev) + an xAI retired-model warning with one-click hermes migrate xai. New v0.15 capability flags gate every surface; pre-v0.15 hosts render the v2.9.x layout unchanged. See v2.10.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.15.2 (latest patch on the v0.15 Velocity Release line, released 2026-05-29) — v0.15.0 baseline ships OpenAI (openai-api) first-class provider, Krea image-gen models, xAI model-retirement aliases (Vercel AI Gateway + Sandbox removed), xAI Web Search backend, ntfy (23rd platform) + per-platform flags, xAI TTS auto_speech_tags, Kanban v0.15 wave (server-side --sort, Promote / Schedule / Delete-permanently actions, Scheduled + Review columns, worktree --branch + model_override display, session-scoped board, --board plumbing), Bitwarden Secrets Manager, MCP mTLS client certs + mcp catalog browse, skill Bundles tab, per-session edit-approval modes (session/set_mode), Health supply-chain audit + xAI migrate action. v0.14.0 / 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.15-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
• Troubleshooting: Update "improperly signed" — recovery if Sparkle rejects an update
• 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-28 — Scarf v2.10.0 (Hermes v0.15 catch-up: OpenAI openai-api first-class provider + Krea image-gen + xAI model-retirement aliases (Vercel removed), xAI Web Search backend, ntfy (23rd platform) + per-platform flags, xAI TTS auto_speech_tags, Kanban v0.15 wave (--sort / Promote / Schedule / Delete-permanently / Scheduled + Review columns / worktree --branch + model_override / session-scoped board / --board plumbing), Bitwarden Secrets Manager, MCP mTLS client certs + mcp catalog, skill Bundles tab, per-session edit-approval modes, Health supply-chain audit + xAI migrate)