<title>Scarf — Native Mac & iOS app for your Hermes AI agent</title>
<metaname="description"content="Scarf is the native macOS and iOS GUI for the Hermes AI agent — sessions, projects, memory, skills, cron, multi-server SSH. Free and open source.">
<metaproperty="og:title"content="Scarf — Native Mac & iOS app for your Hermes AI agent">
<metaproperty="og:description"content="Native macOS and iOS GUI for the Hermes AI agent. Sessions, projects, memory, skills, cron, multi-server SSH. Free and open source.">
<metaname="twitter:title"content="Scarf — Native Mac & iOS app for your Hermes AI agent">
<metaname="twitter:description"content="Native macOS and iOS GUI for the Hermes AI agent. Sessions, projects, memory, skills, cron, multi-server SSH.">
<imgsrc="assets/screenshots/ios-servers.png"alt="ScarfGo — server picker with two configured Hermes hosts"loading="lazy"decoding="async"width="430"height="932">
</div>
<divclass="phone-frame"role="listitem">
<imgsrc="assets/screenshots/ios-chat.png"alt="ScarfGo — chat with the Hermes agent"loading="lazy"decoding="async"width="430"height="932">
<p>Scarf is a native macOS and iOS GUI for the <ahref="https://github.com/hermes-ai/hermes-agent"rel="noopener">Hermes AI agent</a>. 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.</p>
</div>
</details>
<details>
<summary>Do I need Hermes installed first?</summary>
<div>
<p>Yes. Scarf is a client for an existing Hermes installation. It expects to find Hermes's data directory at <code>~/.hermes/</code> on each host you connect to (local or remote). Install Hermes first by following the <ahref="https://github.com/hermes-ai/hermes-agent#installation"rel="noopener">Hermes installation guide</a>.</p>
</div>
</details>
<details>
<summary>Does Scarf work without internet?</summary>
<div>
<p>Yes for the local Hermes case — Scarf reads files and the SQLite database directly from <code>~/.hermes/</code> with no network involvement. Internet is only required when Hermes itself reaches out to model providers or MCP servers, when you connect to a remote Hermes host over SSH, or when checking for Sparkle updates.</p>
</div>
</details>
<details>
<summary>Is Scarf open source?</summary>
<div>
<p>Yes. Both Scarf and ScarfGo are <ahref="https://github.com/awizemann/scarf/blob/main/LICENSE"rel="noopener">MIT licensed</a> and built from the same open repository at <ahref="https://github.com/awizemann/scarf"rel="noopener">github.com/awizemann/scarf</a>. There are no closed-source components and no telemetry.</p>
</div>
</details>
<details>
<summary>What macOS and iOS versions are supported?</summary>
<div>
<p>Scarf for Mac requires macOS 14.6 Sonoma or later, on Apple Silicon or Intel. ScarfGo for iPhone requires iOS 18.0 or later. Both are universal builds; there is no separate Apple Silicon download.</p>
</div>
</details>
<details>
<summary>How does ScarfGo connect to my Mac?</summary>
<div>
<p>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 (with <code>kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly</code>) and is excluded from iCloud sync. Paste the public key into the host's <code>~/.ssh/authorized_keys</code>, and ScarfGo can run <code>hermes acp</code> over the SSH session for chat and read the SQLite database for everything else. There is no companion service or developer-controlled relay.</p>
</div>
</details>
<details>
<summary>What data does Scarf collect?</summary>
<div>
<p>None. Scarf has no telemetry, no analytics, no crash reporter, and no account system. The only outbound network connections are to GitHub Releases (when you check for updates via Sparkle), to remote Hermes hosts you explicitly add, and to Hermes's own model providers and MCP servers — all initiated by Hermes, not Scarf.</p>
</div>
</details>
<details>
<summary>Where are my conversations stored?</summary>
<div>
<p>In Hermes's own data directory — <code>~/.hermes/state.db</code> for session history and <code>~/.hermes/sessions/session_*.json</code> for full transcripts. Scarf reads these files but never writes to <code>state.db</code>. ScarfGo reads them through SSH-initiated SQLite snapshots and never caches them locally on the device.</p>
</div>
</details>
<details>
<summary>How do updates work?</summary>
<div>
<p>Scarf for Mac uses <ahref="https://sparkle-project.org/"rel="noopener">Sparkle</a> for in-app updates — signed and notarized zips with EdDSA signature verification. The appcast lives at <ahref="appcast.xml">awizemann.github.io/scarf/appcast.xml</a>. ScarfGo updates through TestFlight in the usual way until it ships on the App Store.</p>
</div>
</details>
<details>
<summary>Can I use Scarf with a remote or headless Hermes server?</summary>
<div>
<p>Yes — that is one of the main use cases. Add the host through <strong>File → Open Server… → Add Server</strong> on Mac, or tap <strong>Add Server</strong> on the ScarfGo Servers tab. 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 <code>sqlite3</code> and <code>pgrep</code> on its <code>$PATH</code> and the SSH user needs read access to <code>~/.hermes/</code>.</p>
</div>
</details>
<details>
<summary>What's the difference between Scarf and using Hermes from the terminal?</summary>
<div>
<p>Scarf is strictly additive — it visualizes data Hermes already produces. The terminal CLI (<code>hermes chat</code>, <code>hermes cron</code>, <code>hermes mcp</code>, 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.</p>
</div>
</details>
<details>
<summary>Is there a Windows or Linux version?</summary>
<div>
<p>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
<ahref="https://github.com/hermes-ai/hermes-agent"rel="noopener">Hermes CLI</a> itself works on those platforms, and Scarf can connect to a remote Linux Hermes host from a Mac.</p>
"text":"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."
}
},
{
"@type":"Question",
"name":"Do I need Hermes installed first?",
"acceptedAnswer":{
"@type":"Answer",
"text":"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. Install Hermes first by following the Hermes installation guide."
}
},
{
"@type":"Question",
"name":"Does Scarf work without internet?",
"acceptedAnswer":{
"@type":"Answer",
"text":"Yes for the local Hermes case — Scarf reads files and the SQLite database directly from ~/.hermes/ with no network involvement. Internet is only required when Hermes itself reaches out to model providers or MCP servers, when connecting to a remote Hermes host over SSH, or when checking for Sparkle updates."
}
},
{
"@type":"Question",
"name":"Is Scarf open source?",
"acceptedAnswer":{
"@type":"Answer",
"text":"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 and no telemetry."
}
},
{
"@type":"Question",
"name":"What macOS and iOS versions are supported?",
"acceptedAnswer":{
"@type":"Answer",
"text":"Scarf for Mac requires macOS 14.6 Sonoma or later, on Apple Silicon or Intel. ScarfGo for iPhone requires iOS 18.0 or later. Both are universal builds."
}
},
{
"@type":"Question",
"name":"How does ScarfGo connect to my Mac?",
"acceptedAnswer":{
"@type":"Answer",
"text":"ScarfGo speaks SSH directly to your Hermes host using Citadel, a pure-Swift SSH stack. On first launch it generates an Ed25519 keypair on the device — the private key lives in the iOS Keychain and never leaves the phone. Paste the public key into the host's 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 relay."
}
},
{
"@type":"Question",
"name":"What data does Scarf collect?",
"acceptedAnswer":{
"@type":"Answer",
"text":"None. Scarf has no telemetry, no analytics, no crash reporter, and no account system. The only outbound network connections are to GitHub Releases (Sparkle update checks), remote Hermes hosts you explicitly add, and Hermes's own model providers and MCP servers — all initiated by Hermes, not Scarf."
}
},
{
"@type":"Question",
"name":"Where are my conversations stored?",
"acceptedAnswer":{
"@type":"Answer",
"text":"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."
}
},
{
"@type":"Question",
"name":"How do updates work?",
"acceptedAnswer":{
"@type":"Answer",
"text":"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 TestFlight in the usual way until it ships on the App Store."
}
},
{
"@type":"Question",
"name":"Can I use Scarf with a remote or headless Hermes server?",
"acceptedAnswer":{
"@type":"Answer",
"text":"Yes. Add the host through File → Open Server… → Add Server on Mac, or Add Server on ScarfGo. Scarf uses the system SSH config (Mac) or a device-generated key (iOS), so anything reachable through normal terminal SSH works without extra setup. The remote host needs sqlite3 and pgrep on its PATH and the SSH user needs read access to ~/.hermes/."
}
},
{
"@type":"Question",
"name":"What's the difference between Scarf and using Hermes from the terminal?",
"acceptedAnswer":{
"@type":"Answer",
"text":"Scarf is strictly additive — it visualizes data Hermes already produces. The terminal CLI remains the source of truth. 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."
}
},
{
"@type":"Question",
"name":"Is there a Windows or Linux version?",
"acceptedAnswer":{
"@type":"Answer",
"text":"No. Scarf is built on SwiftUI and AppKit and ships only for Apple platforms. The Hermes CLI itself works on those platforms, and Scarf can connect to a remote Linux Hermes host from a Mac."
