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.7.1 — patch release fixing three bugs filed against 2.7.0 (#77 Sessions screen empty, #78 Skills "What's New" pill schizophrenia, #79 hub search misses skills visible in Browse) plus follow-up cleanups in the same neighborhood: tighter pgrep for the gateway probe, port-anchored stop-dashboard (no more pkill -f), and a new scripts/local-build.sh + BUILDING.md for unsigned Debug builds without an Apple Developer account. See v2.7.1 release notes. 2.7.0 highlights are still the headline story — skeleton-then-hydrate chat + Activity loaders, SSH cancellation propagation (no more "third chat hangs / dashboard spins"), in-flight coalescing, New Project from Scratch wizard, Cron + Keychain mirroring, five new dashboard widgets, OAuth keepalive cron, and the ScarfMon perf harness. Full vocabulary in Performance-Monitoring. 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-07 — Scarf v2.7.1 (patch: Sessions empty fix #77, Skills pill schizophrenia #78, hub search misses #79, narrower gateway pgrep, port-anchored stop-dashboard, contributor local-build.sh + BUILDING.md)

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.