Scarf

A native macOS companion app for the Hermes AI agent.
Full visibility into what Hermes is doing, when, and what it creates.

What's New in 2.0

• Multi-server — Manage multiple Hermes installations (local + any number of remotes) from one app. Each window binds to one server; open them side-by-side.
• Remote Hermes over SSH — Every feature that worked against your local ~/.hermes/ now works against a remote host. File I/O routes through scp/sftp; chat ACP runs over ssh -T; SQLite is served from atomic .backup snapshots pulled on file-watcher ticks.
• Chat UX overhaul — No more white-screen flash on first message, no more scroll jumping into whitespace during streaming, failed prompts explain themselves instead of silently spinning forever.
• Correctness pass — Fixed remote WAL error spam, stale-snapshot session resume, auto-resume of dead cron sessions, 230+ Swift 6 concurrency warnings.

See the full v2.0.0 release notes.

Previously, in 1.6

• Platforms — Native GUI setup for all 13 messaging platforms, no more hand-editing .env
• Credential Pools — Fixed OAuth flow and API-key handling; pick providers from a catalog
• Model Picker — Hierarchical browser backed by the 111-provider models.dev cache
• Settings tabs — 10 organized tabs covering ~60 previously hidden config fields
• Configure sidebar — Personalities, Quick Commands, Plugins, Webhooks, Profiles

See the v1.6.0 release notes for the full 1.6 series.

Multi-server, one window per server

Scarf 2.0 is a multi-window app. Each window is bound to exactly one Hermes server — your local ~/.hermes/ is synthesized automatically, and you can add remotes via File → Open Server… → Add Server (host, user, port, optional identity file). Open a second window for a different server and the two run side-by-side with independent state.

Remote Hermes is reached over system SSH — the same ~/.ssh/config, ssh-agent, ProxyJump, and ControlMaster pooling your terminal uses. File I/O flows through scp/sftp; SQLite is served from atomic sqlite3 .backup snapshots cached under ~/Library/Caches/scarf/snapshots/<server-id>/; chat (ACP) tunnels as ssh -T host -- hermes acp with JSON-RPC over stdio end-to-end. Everything in the feature list below works against remote identically to local.

Features

Scarf mirrors Hermes's surface area through a sidebar-based UI. Sections below map 1:1 to the app's sidebar.

Monitor

• Dashboard — System health, token usage, cost tracking, recent sessions with live refresh
• Insights — Usage analytics with token breakdown (including reasoning tokens), cost tracking, model/platform stats, top tools bar chart, activity heatmaps, notable sessions, and time period filtering (7/30/90 days or all time)
• Sessions Browser — Full conversation history with message rendering, model reasoning/thinking display, tool call inspection, full-text search, rename, delete, and JSONL export. Subagent sessions are filtered from the main list and accessible via parent session drill-down
• Activity Feed — Recent tool execution log with filtering by kind and session, detail inspector with pretty-printed arguments and tool output display

Inter

... View full README on GitHub