scarf

Why Scarf

Hermes is a terminal-and-messaging agent — powerful, but invisible. Scarf gives it a face:

• Full visibility. Every session, message, tool call, token, and dollar — live dashboards, full-text search, activity feeds, cost breakdowns.
• Full control. Chat with rich streaming (ACP) or a real terminal, edit memory and skills, manage cron, gateways, MCP servers, and every config key — from a GUI instead of YAML.
• Your servers, no middleman. Local ~/.hermes/ or any number of remote hosts over plain SSH (your existing ~/.ssh/config, agent, ProxyJump). There is no companion service in the middle — nothing between your device and your Hermes host.
• Native and safe. Pure Swift 6 / SwiftUI — no Electron. Hermes state is opened read-only; management actions go through the hermes CLI, so Scarf can't corrupt your agent's data.
• Version-adaptive. Scarf detects each host's Hermes version and capability-gates its UI: Hermes v0.6 through v0.21 all work, and newer-only surfaces simply hide on older hosts.

Available in English, 简体中文, Deutsch, Français, Español, 日本語, and Português (Brasil).

ScarfGo — your agent in your pocket

ScarfGo is the native iPhone companion — the same Hermes servers you run from your Mac, reachable from your phone. Multi-server, project-scoped chat with session resume, project dashboards, skills browsing + Hub install, memory editor, cron, and per-server Hermes profile switching. Hold the composer's mic button to dictate — on-device speech-to-text only, never a server fallback (thanks to @danmarauda) — or start a Live Voice conversation with Hermes when your host supports it. Pure-Swift SSH (Citadel) — the Ed25519 private key is generated on-device, lives in the iOS Keychain, and never leaves the phone.

ScarfGo is now on the App Store — free. Want beta builds on the edge? Join the public TestFlight →

Connecting takes about a minute: add a server (same details as ssh user@host), tap Generate Key, paste the public key into the host's ~/.ssh/authorized_keys, tap Test connection. Full walkthrough: ScarfGo Onboarding · feature tour: ScarfGo · Mac-vs-iOS matrix: Platform Differences.

Privacy

Scarf for macOS collects usage statistics (event names + fixed-vocabulary properties, never content, paths, or hostnames) to guide development. A random per-install identifier is stored on your Mac and sent only as a hash, so active installs can be counted and followed over time without knowing who you are. Opt out any time in Settings → Advanced → Usage Analytics. ScarfGo for iOS collects nothing. Details in the Privacy Policy. The one voice feature that sends data to a third party is Live Voice (GPT-Live mode), and only when you start it: your voice streams directly from your Mac or phone to OpenAI, with recent chat messages as context and Hermes's replies so the voice can speak them, and both apps ask before the first session.

What's New in 3.6.0

• ScarfGo checks your server's identity — it remembers each server's SSH host key on first connect and refuses a server that shows a different one, with both fingerprints and a Trust New Key step in System. Before this, ScarfGo accepted any host key. The Mac app always checked.
• Easier to read in light and dark mode — a deeper orange for buttons and links in light mode, dark text on orange buttons in dark mode, darker status text that passes WCAG AA, and brick-red destructive actions, across both apps.
• Privacy, described accurately — the privacy policy and in-app text now match the code. Live Voice asks for consent once more because the screen now says that Hermes's replies and status lines also go to OpenAI. The Mac setting is now called "usage statistics" instead of "anonymous."
• On macOS 14 Sonoma? Scarf has required macOS 15 since v2.20.0. The update feed now says so, so Sonoma Macs are no longer offered updates that can't open.
• Full notes: releases/v3.6.0/RELEASE_NOTES.md.

All previous releases: Release Notes Index.

Features

Scarf mirrors Hermes's whole surface through a sidebar UI. Sections marked ⚙ are capability-gated — they appear only when the connected host's Hermes version supports them.

Projects — mission control per repo

Projects sit first in the sidebar because that's how you actually work. Selecting one opens a unified cockpit: Dashboard, Sessions, Board, Site, Context, Cron, Memory, Secrets, Templates, Slash commands, Mini-apps, and Fleet.

• Project dashboards — agent-generated JSON dashboards with stat boxes, charts, tables, progress bars, checklists, and embedded web views, live-refreshed. See Project Dashboards below.
• Kanban board ⚙ — full read/write board over Hermes's Kanban, per-project tenants, chat-scoped views.
• Mini-apps — sandboxed HTML/CSS/JS panels inside a project that can drive your agent through a rate-limited, permission-gated bridge (locked-down WKWebView, default-deny permissions reviewed on first open).
• Fleet & Portfolio — the same repo on several machines groups into one logical project; Scarf flags config drift and can push model presets, boards, and cron to the whole fleet.
• Templates — install .scarftemplate bundles from the community catalog, a local file, or a scarf://install link; export your own.
• Project chats load your context — chats spawn Hermes with the project as cwd, so AGENTS.md / CLAUDE.md / .cursorrules load automatically, on Mac and iOS alike.

Monitor

• Dashboard — system health, token usage, cost tracking (per-model breakdown on Hermes 0.20), recent sessions.
• Insights — usage analytics: token/cost trends, model + platform stats, top tools, activity heatmaps, 7/30/90-day filtering.
• Sessions — full conversation history with reasoning display, tool-call inspection, full-text search, pin/rename/delete, and Markdown/HTML/Quarto/JSONL export with secret redaction.
• Activity — live tool-execution feed with filtering and a detail inspector.

Interact

• Chat — two modes: Rich Chat streams over the Agent