1. 项目定位与用途
Scarf 是 Hermes AI agent 的官方原生 Mac 与 iOS 客户端，iOS 端配套应用名为 ScarfGo，定位为 Hermes 生态的官方 GUI 管理工具。Hermes 原本是终端+消息形态的 AI agent，功能强大但无可视化界面，Scarf 为其提供了完整的图形化操作入口，让用户可以在 Mac 和 iPhone 上直观查看、管理 Hermes 的全量运行状态，无需依赖终端命令即可完成大部分操作，是 Hermes 用户的首选可视化管理工具。
项目档案应用项目
Scarf：Hermes AI agent 官方原生 Mac/iOS 客户端，可视化管理 AI 代理全量状态
Scarf 是 Hermes AI agent 的官方原生 Mac 与 iOS 客户端，为终端形态的 Hermes 提供可视化 GUI 界面，支持本地与 SSH 远程多服务器管理，可查看会话、项目、技能、内存等全量状态，本文介绍其定位、安装与使用方法。
AI 总结
Scarf 是 Hermes AI agent 的官方原生 Mac 与 iOS 客户端，为原本仅终端可用的 Hermes 提供可视化 GUI 界面，支持本地与 SSH 远程多服务器管理，无需中间代理即可安全管控 Hermes 全量状态。
中文项目介绍
Scarf 是 Hermes AI agent 的官方原生客户端，覆盖 macOS 与 iOS 双平台，iOS 端配套应用名为 ScarfGo。
Hermes 原本是终端+消息形态的 AI agent，功能强大但无可视化界面，用户无法直观监控会话、工具调用、Token 消耗与费用明细，配置管理需手动编辑 YAML 文件，跨设备访问远程 Hermes 实例也不便。Scarf 正是为解决上述痛点而生，为 Hermes 提供完整的图形化操作入口。
Scarf 基于 Swift 6/SwiftUI 原生开发，无 Electron 等跨平台中间层，也无中间代理服务，直接连接本地 Hermes 实例或通过 SSH 复用现有配置连接远程主机。Hermes 数据以只读方式打开，所有管理操作通过 hermes CLI 执行，避免损坏 agent 数据。
用户可通过 Scarf 可视化查看会话、项目仪表盘、技能库、内存文件、定时任务、MCP 服务器等 Hermes 全量状态，支持 ACP 协议流式聊天或内置终端交互，兼容 Hermes v0.6 至 v0.20 版本，支持 7 种语言。
详细信息与使用说明
2. 解决的问题
Hermes AI agent 原生形态为终端+消息工具，无可视化界面，用户无法直观监控会话、工具调用、Token 消耗与费用明细，配置管理需手动编辑 YAML 文件，操作门槛高且易出错，跨设备访问远程 Hermes 实例也不便。Scarf 解决了上述全部痛点，提供原生 GUI 替代终端操作，无需中间代理即可安全连接本地或远程 Hermes 主机，大幅降低 Hermes 的使用与管理成本。
3. 适用场景
适用于多类 Hermes 使用场景：在 Mac 上可视化监控 Hermes 会话、查看项目数据、统计资源消耗的桌面场景；通过 iPhone 远程 SSH 连接 Hermes 服务器，管理会话、技能、定时任务的移动场景；需要 GUI 化配置 Hermes MCP 服务器、网关、内存等参数，避免手动编辑 YAML 的配置场景；以及统一管理多个本地+远程 Hermes 服务器的多服务器管理场景。
4. 安装方式
仓库中明确给出的安装方式分为两类：macOS 端可从 GitHub Releases 页面下载最新安装包直接安装；iOS 端（ScarfGo）需通过 TestFlight 链接加入测试后安装。系统要求为 macOS 14.6+、iOS 18+，兼容 Hermes v0.6 至 v0.20 版本，安装过程无需额外复杂配置。
5. 使用方式
首次使用需添加 Hermes 服务器，支持选择本地 ~/.hermes/ 目录，或通过 SSH（复用 ~/.ssh/config、SSH agent、ProxyJump 配置）添加远程主机；添加后可查看会话列表、项目仪表盘、技能库、内存文件、定时任务、MCP 服务器等 Hermes 全量状态，支持通过 ACP 协议流式聊天或使用内置终端与 Hermes 交互；软件会自动检测对应 Hermes 版本，能力不匹配的 UI 功能会自动隐藏。
6. 补充说明与实现特点
Scarf 基于 Swift 6/SwiftUI 原生开发，无 Electron 等跨平台中间层，无中间代理服务，直接连接 Hermes 主机保障数据安全；Hermes 状态以只读方式打开，管理操作通过 hermes CLI 执行，避免损坏 agent 数据；支持英语、简体中文、德语、法语、西班牙语、日语、葡萄牙语（巴西）共 7 种语言；配套自包含设计系统静态站点与 React UI Kit，可用于原型设计与营销素材制作，另有社区模板生态支持用户快速搭建预配置 Hermes 项目。
思维导图
Scarf
核心定位
Hermes AI agent 官方原生客户端
覆盖 macOS 与 iOS 双平台
iOS 端配套应用名为 ScarfGo
核心功能
多服务器管理（本地+SSH 远程）
会话与聊天交互（ACP 流式/内置终端）
项目仪表盘
技能与内存管理
定时任务与 MCP 管理
配置与安全管控
技术实现
Swift 6/SwiftUI 原生开发
无中间代理服务
SSH 远程连接（复用现有 SSH 配置）
版本自适应（兼容 Hermes v0.6-v0.20）
Hermes 数据只读访问，操作走 hermes CLI
配套生态
自包含设计系统静态站点
React UI Kit（高保真复刻原生界面）
社区 .scarftemplate 模板
平台与本地化
macOS 14.6+
iOS 18+（ScarfGo）
支持 7 种语言
常见问题
Scarf 支持哪些系统版本？
根据仓库公开信息，Scarf 支持 macOS 14.6 及以上版本，iOS 端 ScarfGo 支持 iOS 18 及以上版本。
Scarf 如何连接远程 Hermes 服务器？
Scarf 支持通过 SSH 连接远程 Hermes 主机，可复用用户现有的 ~/.ssh/config 配置、SSH agent 以及 ProxyJump 设置，无需额外配置中间代理服务。
Scarf 会修改或损坏我的 Hermes 数据吗？
不会。Scarf 读取 Hermes 状态时采用只读模式，所有管理操作均通过 hermes CLI 执行，不会直接修改 Hermes 的原始数据，避免数据损坏风险。
Scarf 兼容哪些版本的 Hermes？
Scarf 兼容 Hermes v0.6 至 v0.20 版本，软件会自动检测对应主机的 Hermes 版本，能力不匹配的 UI 功能会自动隐藏，确保兼容性。
Scarf 支持哪些语言？
根据仓库信息，Scarf 支持英语、简体中文、德语、法语、西班牙语、日语、葡萄牙语（巴西）共 7 种语言。