Scarf
Scarf is a native macOS and iOS GUI for the Hermes AI agent. See every session, project, skill, memory file, and cron job — locally on your Mac and remotely from your iPhone over SSH.
Requires Hermes installed at ~/.hermes/.
Scarf is a native macOS and iOS GUI for the Hermes AI agent. It surfaces every part of a
running Hermes installation — chat sessions, project workspaces, memory files, installed
skills, MCP servers, cron jobs, messaging gateways, logs, and configuration — through a
sidebar-driven app on Mac and a tab-based companion on iPhone. Scarf reads from
~/.hermes/state.db directly (read-only), streams agent replies in real time
over the Agent Client Protocol, and connects to remote Hermes installations through your
existing SSH config. There is no Scarf account and no companion cloud service. The Mac app
sends usage statistics (never chats, files, paths, or hostnames), on by default and
switchable off in Settings; ScarfGo sends none. See the privacy policy.
Real-time streaming chat over the Agent Client Protocol. Tool calls render inline with collapsible argument and output panes. Tool-permission requests surface as interactive dialogs you can approve, deny, or stage. Reasoning and thinking blocks display when the model emits them. Resume any prior session from the sidebar, or jump back into a conversation that disconnected — Scarf reconnects to the same session id.
Per-project chat with the agent's working directory pinned, custom dashboards rendered
from a JSON spec the agent itself can author, project-scoped slash commands defined as
Markdown files, and a Scarf-managed AGENTS.md block that gives Hermes
project context before every session boots. Templates package these into a single
.scarftemplate bundle you can share or install with one click.
One window per Hermes server. Local ~/.hermes/ is synthesized
automatically; remote servers connect through your existing
~/.ssh/config, ssh-agent, ProxyJump, and ControlMaster. File I/O routes
through scp/sftp; the SQLite database is served from atomic snapshots; chat tunnels as
ssh -T host hermes acp with JSON-RPC end-to-end. There is no companion
service in the middle.
Edit MEMORY.md and USER.md with live file-watcher refresh and
external-provider awareness. Browse the Skills Hub across six registries, install,
update, and inspect SKILL.md frontmatter. Configure MCP servers from a
curated preset list (GitHub, Linear, Notion, Sentry, Stripe) or fully custom; test the
connection in-app and watch the discovered tool list populate.
Create, edit, pause, resume, run-now, and delete cron jobs without touching the CLI — with human-readable schedules ("Every weekday at 9:00 AM") and the underlying expression a tap away. Native GUI for thirteen messaging platforms (Telegram, Discord, Slack, WhatsApp, Signal, iMessage, Email, Matrix, Mattermost, Feishu, Home Assistant, Webhook, CLI) with per-platform credential forms and connectivity dots.
Token usage and cost broken down by day, model, and platform; reasoning tokens tracked separately. Activity heatmaps and notable sessions across 7, 30, 90 days, or all time. Component-level health checks, on-demand diagnostics, and a one-click debug report uploader for Hermes support — with a confirmation dialog before anything leaves the machine.
ScarfGo for iPhone
ScarfGo is the native iOS companion to Scarf. It speaks SSH directly to your Hermes
host using Citadel — a
pure-Swift SSH stack, no companion service, no developer-controlled relay. Generate an
Ed25519 keypair on the device, paste the public half into authorized_keys,
and you have full project-aware chat, session resume, memory editing, cron browsing,
and skills browsing with Hub install on iOS 18.6+.
AGENTS.md block as Mac.
On the edge? Join the public TestFlight beta →
One Mach-O binary. SwiftUI on macOS 15+ and iOS 18.6+. A fraction of the memory and energy of a bundled Chromium. Drag-and-drop, sharing, the menu bar, Spotlight, and accessibility all behave the way a Mac or iPhone user expects.
Scarf opens ~/.hermes/state.db in read-only WAL mode. The app cannot
corrupt your Hermes data even if it crashes mid-write — because it never writes.
Memory files and cron jobs are the only mutable surfaces, both with explicit
confirmations.
MIT licensed, pure
Swift, zero external runtime dependencies. Build it yourself with
one xcodebuild command. Sparkle auto-updates ship signed,
notarized, EdDSA-verified zips — never silent over-the-wire mutations.
A .scarftemplate bundle packages a project's dashboard, skills, cron jobs,
memory blocks, slash commands, and configuration schema into one shareable file.
Browse the public catalog and install with a single click.
Want beta builds? Join the public TestFlight →
Both apps require Hermes
installed at ~/.hermes/ on each host you want to manage. Scarf does not include
Hermes itself — see the
Hermes installation
guide first.
Scarf is a native macOS and iOS GUI for the Hermes AI agent. It surfaces Hermes's sessions, projects, memory, skills, MCP servers, cron jobs, messaging gateways, logs, and configuration through a sidebar-driven Mac app and a tab-based iPhone companion called ScarfGo.
Yes. Scarf is a client for an existing Hermes installation. It expects to find Hermes's data directory at ~/.hermes/ on each host you connect to (local or remote). Install Hermes first by following the Hermes installation guide.
Yes, for local work. With a local Hermes, Scarf reads files and the SQLite database directly from ~/.hermes/ with no network involvement, and SSH hosts on your local network keep working offline. Internet is needed when Hermes itself calls model providers or MCP servers, for SSH hosts outside your network, Sparkle update checks, the template catalog and template downloads, Nous Portal's model list, Live Voice, and dashboard widgets that load remote URLs. The Mac app's usage analytics wait on disk while you're offline and are sent once you reconnect.
Yes. Both Scarf and ScarfGo are MIT licensed and built from the same open repository at github.com/awizemann/scarf. There are no closed-source components — including the Mac app's opt-out usage analytics, whose event code is in the source.
Scarf for Mac requires macOS 15 Sequoia or later, on Apple Silicon or Intel. ScarfGo for iPhone requires iOS 18.6 or later. The main download is a universal build that runs natively on Apple Silicon and Intel; a smaller Apple Silicon–only build is also on the GitHub Releases page.
ScarfGo speaks SSH directly to your Hermes host using a pure-Swift SSH stack (Citadel). On first launch it generates an Ed25519 keypair on the device — the private key lives in the iOS Keychain, pinned to that device by default (kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly). Syncing it to your other devices through iCloud Keychain is off unless you turn it on in the System tab. Paste the public key into the host's ~/.ssh/authorized_keys, and ScarfGo can run hermes acp over the SSH session for chat and read the SQLite database for everything else. There is no companion service or developer-controlled relay.
Usage statistics from the Mac app; ScarfGo sends the developer nothing. Scarf for macOS records events such as “chat session started” with short fixed labels, counts, and bucketed timings, plus device context such as macOS version, Mac model, and locale — never anything you typed or named, file paths, or hostnames. A random install ID, stored on your Mac, is sent only as a salted hash, so events are pseudonymous, not tied to you. On by default; turn it off in Settings → Advanced → Usage Analytics. There is no Scarf account and no crash upload, though ScarfGo TestFlight testers share crash reports with the developer through Apple. Live Voice (both apps, only when you start it) streams your microphone audio and recent chat messages directly to OpenAI, which also sees your IP address. Other connections include SSH to your Hermes hosts, Sparkle updates (GitHub), the template catalog and template downloads, Nous Portal's model list (with your Nous key), and URLs that dashboard widgets load. The privacy policy has the full list.
In Hermes's own data directory — ~/.hermes/state.db for session history and ~/.hermes/sessions/session_*.json for full transcripts. Scarf reads these files but never writes to state.db. ScarfGo reads them through SSH-initiated SQLite snapshots and never caches them locally on the device.
Scarf for Mac uses Sparkle for in-app updates — signed and notarized zips with EdDSA signature verification. The appcast lives at awizemann.github.io/scarf/appcast.xml. ScarfGo updates through the App Store, or through TestFlight if you joined the public beta.
Yes — that is one of the main use cases. Add the host through File → Open Server → Manage Servers… → Add on Mac, or tap + (Add server) on ScarfGo's Servers screen. Scarf uses the system SSH config (Mac) or a device-generated key (iOS), so anything reachable through your normal terminal SSH workflow works without extra setup. The remote host needs sqlite3 and pgrep on its $PATH and the SSH user needs read access to ~/.hermes/.
Scarf is strictly additive — it visualizes data Hermes already produces. The terminal CLI (hermes chat, hermes cron, hermes mcp, etc.) remains the source of truth for everything. Scarf gives you live streaming chat with rich tool-call rendering, multi-server windows, project workspaces with custom dashboards, and a one-pane view of skills, MCP servers, cron jobs, and gateways without memorizing CLI subcommands.
No. Scarf is built on SwiftUI and AppKit and ships only for Apple platforms. There are no current plans for Windows or Linux ports — the Hermes CLI itself works on those platforms, and Scarf can connect to a remote Linux Hermes host from a Mac.