📄 工具详情 ⚙️ 安装教程 📚 使用教程
能力标签
🔌 MCP🤖 Agent🔄 工作流🐳 Docker💻 CLI🔗 REST API🔊 TTS🎙 STT🧠 Claude✨ GPT
scarf MCP工具
🛠
AI工具

scarf MCP工具

基于 Swift · 开源 AI 工具，GitHub 社区精选
英文名：scarf
⭐ 502 Stars 🍴 31 Forks 💻 Swift 📄 MIT 🏷 AI 8.2分
8.2AI 综合评分
MCP工具AI代理macOS应用Swift开发多窗口管理
🌐 访问官网 📺 TG 频道
✦ AI Skill Hub 推荐

AI Skill Hub 强烈推荐：scarf MCP工具 是一款优质的AI工具。AI 综合评分 8.2 分，在同类工具中表现稳健。如果你正在寻找可靠的AI工具解决方案，这是一个值得深入了解的选择。

📚 深度解析

scarf MCP工具 是一款基于 Swift 的开源工具，在 GitHub 上收获 1k+ Star，是MCP工具、AI代理、macOS应用、Swift开发领域中的优质开源项目。开源工具的最大优势在于代码完全透明，你可以审计每一行代码的安全性，也可以根据自身需求进行二次开发和定制。

**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。

**安装与环境准备**
scarf MCP工具 依赖 Swift 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 Swift 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。

**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪 scarf MCP工具 的版本更新，及时通知重要功能变化。

📋 工具概览

为Hermes AI智能体打造的原生macOS和iOS应用，支持多窗口、多服务器连接。提供图形化界面管理AI代理任务，适合需要桌面级AI工具体验的开发者和专业用户。

scarf MCP工具 是一款基于 Swift 开发的开源工具，专注于 MCP工具、AI代理、macOS应用 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。

GitHub Stars
⭐ 502
开发语言
Swift
支持平台
macOS / iOS
维护状态
正常维护，社区驱动
开源协议
MIT
AI 综合评分
8.2 分
工具类型
AI工具
Forks
31

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

为Hermes AI智能体打造的原生macOS和iOS应用，支持多窗口、多服务器连接。提供图形化界面管理AI代理任务，适合需要桌面级AI工具体验的开发者和专业用户。

scarf MCP工具 是一款基于 Swift 开发的开源工具，专注于 MCP工具、AI代理、macOS应用 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。

📌 核心特色
  • 开源免费，支持本地部署，数据完全自主可控
  • 活跃的 GitHub 开源社区，持续迭代更新
  • 提供详细文档和使用示例，新手友好
  • 支持自定义配置，灵活适配不同使用环境
  • 可作为基础组件集成进现有技术栈或进行二次开发
🎯 主要使用场景
  • 本地部署运行，保护数据隐私，满足合规要求
  • 自定义集成到现有系统，扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发
以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。
安装命令
# 克隆仓库
git clone https://github.com/awizemann/scarf
cd scarf

# 查看安装说明
cat README.md

# 按 README 完成环境依赖安装后即可使用
📋 安装步骤说明
  1. 访问 GitHub 仓库页面
  2. 按照 README 文档完成依赖安装
  3. 根据系统环境完成初始化配置
  4. 参考官方示例或文档开始使用
  5. 遇到问题可在 GitHub Issues 中查找解答
以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。
常用命令 / 代码示例
# 查看帮助
scarf --help

# 基本运行
scarf [options] <input>

# 详细使用说明请查阅文档
# https://github.com/awizemann/scarf
以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。
配置示例
# scarf 配置说明
# 查看配置选项
scarf --config-example > config.yml

# 常见配置项
# output_dir: ./output
# log_level: info
# workers: 4

# 环境变量（覆盖配置文件）
export SCARF_CONFIG="/path/to/config.yml"
📑 README 深度解析 真实文档 完整度 82/100 查看 GitHub 原文 →
以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

简介

<p align="center"> <img src="icon-v2.5.png" width="128" height="128" alt="Scarf app icon"> </p>

Scarf

<p align="center"> A native macOS companion app for the <a href="https://github.com/hermes-ai/hermes-agent">Hermes AI agent</a>.<br> Full visibility into what Hermes is doing, when, and what it creates. </p>

<p align="center"> <img src="https://img.shields.io/badge/macOS-14.6+%20Sonoma-blue" alt="macOS"> <img src="https://img.shields.io/badge/Swift-6-orange" alt="Swift"> <img src="https://img.shields.io/badge/license-MIT-green" alt="License"> <br> <em>Available in English, 简体中文, Deutsch, Français, Español, 日本語, and Português (Brasil).</em> <br><br> <a href="https://www.buymeacoffee.com/awizemann"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me a Coffee" height="28"></a> </p>

What's New in 2.15.0

Projects grow up — the biggest Projects update since v2.3. A project becomes a first-class object with its own mission-control pane, and gains three new powers. (Skips 2.14; this is a feature release, not a Hermes-compat one.)

  • Mini-apps — sandboxed web panels (plain HTML/CSS/JS) that live inside a project and can drive your agent. They run in a locked-down WKWebView (no network, scoped assets, symlink-contained file reads) with default-deny permissions you review on first open. A mini-app's scarf.prompt(...) gets its own isolated, rate-limited hermes acp session — it can't reach your chats. Build one with the scarf-miniapp-author skill, or have Upgrade Project generate a starter. (v1 wires the read + prompt surfaces; kanban:write / file:write / net are declared but not yet enabled.)
  • Fleet & Portfolio — run the same repo on more than one machine and Scarf groups them as one logical project, flags config drift across hosts, and lets you Apply to Fleet to push a host's model preset, board, and cron jobs to the others (per-host, non-fatal, version-gated).
  • One-click Upgrade Project — bring an existing repo up to the full experience: a fast idempotent structural pass (stable id, board, AGENTS.md block, dashboard) then an agent hand-off that tailors a dashboard, slash commands, cron, and a starter mini-app.
  • The cockpit — selecting a project opens one unified pane with everything about it: Dashboard, Sessions, Board, Site, Context, Cron, Memory, Secrets, Templates, Slash, Mini-apps, and Fleet.
  • Project chats load your AGENTS.md — opening a chat in a project now spawns Hermes with the project as its cwd, so the agent gets the project's AGENTS.md / CLAUDE.md / .cursorrules automatically (new, resumed, and reconnected chats). Treat a project's context files like its code — only open chats in projects you trust.
  • Hardening: remote SSH paths escaped against command injection; window size/position persists again.

See the full v2.15.0 release notes.

What's New in 2.13.0

ScarfGo — the iOS companion — gets Hermes profile switching, plus a remote-chat/Settings reliability fix that anyone running ScarfGo over SSH will feel. The shared-core pieces ride into the Mac app too.

  • Switch Hermes profiles from ScarfGo — pick a profile and ScarfGo points its chat, memory, cron, sessions, gateway, and every hermes call at that profile for the selected server. It uses per-connection scoping and never runs hermes profile use, so it doesn't touch the host's active_profile — your Mac, terminal, cron, and running gateway keep their own profile. (Create / rename / delete / import / export stay Mac-only.) (#120)
  • Reliable remote chat & Settings on iOS — fixes "Couldn't save model.provider … Transport refused" and empty Settings on a valid host. ScarfGo was opening a new SSH connection per read / CLI call; under a Settings-load or chat-init burst the handshake itself failed. It now pools one connection per server and coalesces concurrent opens (verified against a live sshd: a 24-way burst went from 20/24 connection failures to 0). (#112)
  • Skills "What's New" tracks per profile — the pill no longer shows bogus "new / changed" counts after a profile switch; the baseline is now keyed per (server, profile).

See the full v2.13.0 release notes.

What's New in 2.12.0

A coordinated catch-up to Hermes v0.17.0 (2026.6.19) — the largest Hermes release yet, though Scarf needed only a focused slice — plus a remote-chat performance fix everyone on SSH will feel. Every new v0.17 surface is capability-gated, so pre-v0.17 hosts render byte-identical to v2.11.0; all flag/config/wire shapes were verified against the live v0.17 source.

  • Remote chat is responsive again — typing into a session on a remote (SSH) host no longer lags or spikes CPU. Watcher-driven reads (credential preflight, sessions list, platforms, projects) that were doing synchronous SSH round-trips on the main thread per message now run off-main with cancel-prior + recency guards. (#119)
  • Four broken Health/Settings actions fixed — surfaced by the v0.17 audit: "Run supply-chain audit" (hermes audit → security audit), xAI model migration (was dry-run only — now --apply), browser-tools setup (--assume-yes → --yes), and the no-op WhatsApp recipient allowlist (removed). Failed config saves now show the real reason.
  • Curator "Prune" → "Archive idle skills" — the old action claimed to delete archived skills from disk, but the real verb archives idle active skills (reversibly) and Scarf was invoking it wrong (it would hang). Rebuilt to match: a day-threshold picker, an idle-skill preview, and a correctly reversible confirm.
  • New gateway platforms — WhatsApp Business Cloud API (Meta-hosted, distinct from the QR web bridge) gets a full credential form, and SimpleX finally gets a setup form (it had no UI since v0.14).
  • More v0.17 surfaces — Telegram rich messages (Bot API 10.1) + online/offline status toggles; a curator-consolidation toggle (v0.17 made the LLM merge pass opt-in); and a max-concurrent-sessions cap.
  • Under the hood: v0.17 required zero mandatory compatibility changes (schema, ACP, CLI, config, catalog all stable — verified against source), so this is a feature catch-up plus pre-existing-bug fixes; new capability flags + isV017OrLater; an adversarial fresh-eyes audit of the branch caught a real bug pre-release; 642 ScarfCore tests.

See the full v2.12.0 release notes.

What's New in 2.11.0

A coordinated catch-up to Hermes v0.16.0 (2026.6.5), headlined by a correctness fix for the first state.db schema change since v0.11. Every new surface is capability-gated or schema-detected, so pre-v0.16 hosts render byte-identical to v2.10.3.

  • Rewound messages are hidden (the schema change) — v0.16 soft-deletes messages when you /undo a conversation (a new messages.active column). Scarf now filters them out on every read path, schema-gated so older hosts don't error, so a rewound chat shows you what the agent actually sees instead of discarded messages.
  • Live session titles — Scarf updates a session's name in the Mac sidebar in place when Hermes (re)generates it, via the new ACP session_info_update notification.
  • "Rewound ×N" badge — sessions schema-detect the new sessions.rewind_count column and flag heavily-edited sessions in the sidebar, the Sessions table, and the dashboard.
  • Spotify sign-in moved to Plugins — Spotify became a built-in tool/plugin in v0.16, so its sign-in affordance now lives in the Plugins view on v0.16 hosts (kept in Skills for older ones).
  • Two gateway-config bugs fixed — platform allowlists were written to the wrong YAML location and silently never applied (now top-level slack.allowed_channels etc., DingTalk corrected to allowed_chats); and the cross-profile gateway digest, which assumed a non-existent --json flag, now parses the text output and shows up again.
  • v0.16 quick wins — an "Optimize sessions database" Health action (hermes sessions optimize), a Kanban "Goal · N" pill, and capability-gated session rename.
  • Under the hood: config-shape corrections verified against the live v0.16 source (OpenRouter response-cache scalar so a disable takes effect, MCP SSE add path, dead Kanban verify verb removed, ACP /goal//subgoal de-advertised as gateway-only); AWS Bedrock registered + new providers/models flow automatically; new v0.16 capability flags + isV016OrLater; 628 ScarfCore tests.

See the full v2.11.0 release notes.

What's New in 2.10.3

A reliability and polish release on top of v2.10.1/v2.10.2, headlined by a fix for the 100% single-core CPU spin on large state.db files, plus a broad performance + correctness sweep from a full code audit.

  • 100% CPU fix (gh#102) — the Dashboard no longer closes + reopens the SQLite handle on every file-change tick; on a large state.db + uncheckpointed WAL that close+reopen was the whole cost. The read-only handle now stays open and sees Hermes's writes transparently.
  • Menu-bar stopped flashing every 10s (gh#105) — ServerLiveStatus only republishes @Observable state when the value actually changes, so unchanging healthy polls no longer re-render the status chrome.
  • Reasoning visible again on resumed thinking-model chats — the REASONING disclosure reappears on resume (including the newest models that store only reasoning_content) and lazy-loads the chain-of-thought on open, keeping the fast two-phase loader's speed.
  • Snappier sidebar navigation — switching sections no longer re-runs each feature's remote load() over SSH; panes keep their data + state across switches and refresh only on real file changes or Reload.
  • Self-diagnostic Docker config errors (gh#112) — a failed hermes config set now surfaces the wrapper's real exit code + stderr instead of a generic "Couldn't save."
  • Plus loading overlays on more panes, standard menu commands (⌘, Settings, Help menu, ⌘F search), a backgrounded-poll throttle, cron-corruption warnings, and chat-streaming polish.
  • Under the hood: zero compiler warnings across the macOS app, iOS app, and ScarfCore package (full Swift 6 strict-concurrency cleanup); a parallel-safe 613-test suite that no longer touches your real ~/.hermes; and a Sparkle release-key safeguard.

This release also carries v2.10.2's ACP permission-prompt fix ("Allow Once" / "Allow For Session" now reach Hermes correctly). See the full v2.10.3 release notes.

What's New in 2.10.1

A "projects fundamentals" maintenance release on top of v2.10.0. Six interlocking fixes from user feedback:

  • Global /scarf-* slash commands — six bundled commands (scarf-new, scarf-help, scarf-dashboard, scarf-widget, scarf-cron, scarf-export) available in every chat, not just per-project. Loaded from ~/.hermes/scarf/slash-commands/ and bootstrapped on launch with the same version-gated upgrade pattern as bundled skills.
  • Skills sidebar finally shows scarf-template-author — SkillBootstrapService installs into ~/.hermes/skills/scarf/ (matching SkillsScanner's <category>/<skill>/SKILL.md layout) and auto-migrates the old flat install. One-time migration runs at first launch.
  • Pre-session slash menu — typing / before opening a chat now shows the full agent-command set greyed-out ("Available once a chat is open") instead of collapsing to just /new.
  • New-project wizard hand-off — kickoff prompt rewritten with SKILL: / PROJECT_PATH: anchors that agents reliably treat as invocation markers (vs. the polite "use the skill" sentence agents routinely ignored). Skill-presence preflight in commit() guarantees the bundled skill is on disk before session/new.
  • AGENTS.md scarf-project block: Scarf platform reference — the managed block now describes Scarf's dashboard widget vocabulary, project slash commands, Kanban tenant, model presets, typed config, cron --workdir, skill loading, and template export. Idempotent + secret-safe + capped to ~30 lines. Now refreshed on template install too (previously chat-start only).
  • Health: capabilities diagnostic panel — raw hermes --version line, parsed semver/date, per-release flag list, and a Re-detect button. Capabilities auto-refresh on NSApplication.didBecomeActive so hermes update outside Scarf is picked up without a relaunch.

See the full v2.10.1 release notes.

What's New in 2.10

A coordinated catch-up to Hermes v0.15.0 ("The Velocity Release"). v2.10 surfaces the Scarf-relevant slice of the largest Hermes release yet — OpenAI as a first-class provider, the 104-PR Kanban maturation wave, Bitwarden Secrets Manager, MCP mTLS, skill bundles, per-session edit-approval modes, plus ntfy, xAI Web Search, and the xAI model-retirement migration. New v0.15 capability flags gate every surface; pre-v0.15 hosts render byte-identical to v2.9.x. (All flag/config/wire shapes were verified against the v2026.5.28 Hermes source before implementation.)

Features

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

Remote setup requirements

The remote host must have:

  1. SSH access — key-based auth via your local ssh-agent. Scarf never prompts for passphrases; run ssh-add once in Terminal before connecting.
  2. sqlite3 on the remote $PATH — needed for the atomic DB snapshots. Install on the remote with apt install sqlite3 (Ubuntu/Debian), yum install sqlite (RHEL/Fedora), or apk add sqlite (Alpine).
  3. pgrep on the remote $PATH — used by the Dashboard "is Hermes running" check. Standard on every distro; install procps if missing.
  4. ~/.hermes/ readable by the SSH user. When Hermes runs as a separate user (systemd service, Docker container), the SSH user needs read access to config.yaml and state.db. Either (a) SSH as the Hermes user, (b) chmod Hermes's home to be group-readable and add your SSH user to that group, or (c) set the Hermes data directory field when adding the server to point at the right location (e.g. /var/lib/hermes/.hermes).

Requirements

  • macOS 14.6+ (Sonoma) for Scarf
  • iOS 18.0+ for ScarfGo (the iPhone companion, public TestFlight from v2.5)
  • Xcode 16.0+ to build from source
  • Hermes agent v0.6.0+ installed at ~/.hermes/ on each target host (v0.17.0+ recommended for the full v2.12 surface — WhatsApp Business Cloud API + SimpleX setup forms, Telegram rich-messages / online-offline status toggles, an opt-in curator-consolidation toggle, and a max-concurrent-sessions cap, on top of the v0.16 soft-delete/rewind correctness fixes and the broader v0.13–v0.15 feature set. Older hosts down to v0.6.0 work — every release-gated surface is capability-gated and simply hidden on hosts that don't support it.)
  • For remote servers: SSH access (key-based), sqlite3 on the remote (for atomic DB snapshots), and the hermes CLI resolvable from the remote user's PATH or at a path you specify per server. ScarfGo requires the same on every Hermes host it connects to.

Dependencies

PackagePurpose
[SwiftTerm](https://github.com/migueldeicaza/SwiftTerm)Terminal emulator for the Chat feature
[Sparkle](https://github.com/sparkle-project/Sparkle)Auto-updates from the GitHub-hosted appcast

Everything else uses system frameworks: SQLite3 C API, Foundation JSON, AttributedString markdown, SwiftUI Charts, GCD file watching.

Install

Build from Source

git clone https://github.com/awizemann/scarf.git
cd scarf/scarf
open scarf.xcodeproj

Or from the command line:

xcodebuild -project scarf/scarf.xcodeproj -scheme scarf -configuration Release -arch arm64 -arch x86_64 ONLY_ACTIVE_ARCH=NO build

For an unsigned local Debug build without an Apple Developer account (handy for contributors), use ./scripts/local-build.sh — see BUILDING.md for prerequisites.

What You Can Build

  • Development dashboards — test coverage, build status, open issues, sprint progress
  • Data project trackers — pipeline metrics, data quality scores, processing throughput
  • Deployment monitors — deploy history tables, uptime stats, error rate charts
  • Research dashboards — experiment results, key findings, paper status checklists
  • Agent activity views — cron job results, content generation stats, task completion rates
  • Embedded web apps — local dev servers, HTML reports, Grafana dashboards, any web-based tool your agent generates
  • Any project status — if your agent can measure it, Scarf can display it

Quick Start

1. Create the dashboard file

Create .scarf/dashboard.json in any project folder:

{
  "version": 1,
  "title": "My Project",
  "description": "Project status at a glance",
  "sections": [
    {
      "title": "Overview",
      "columns": 3,
      "widgets": [
        {
          "type": "stat",
          "title": "Test Coverage",
          "value": "87%",
          "icon": "checkmark.shield",
          "color": "green",
          "subtitle": "+2.1% this week"
        },
        {
          "type": "progress",
          "title": "Sprint Progress",
          "value": 0.73,
          "label": "73% complete",
          "color": "blue"
        },
        {
          "type": "list",
          "title": "Tasks",
          "items": [
            { "text": "Write unit tests", "status": "done" },
            { "text": "Update API docs", "status": "active" },
            { "text": "Deploy to prod", "status": "pending" }
          ]
        }
      ]
    }
  ]
}

2. Register your project

Have your agent append a {name, path} entry directly to the registry at ~/.hermes/scarf/projects.json — Scarf watches the file and picks up the change on the next sidebar refresh, no manual UI step needed:

{
  "projects": [
    { "name": "my-project", "path": "/Users/you/Developer/my-project" }
  ]
}

(You can also add the folder by hand in Scarf via Projects → + if you'd rather click than edit JSON — both paths write to the same file.)

3. View in Scarf

Select your project in the Projects sidebar — the dashboard renders immediately. Scarf watches the file for changes and refreshes automatically whenever the JSON is updated.

Configure *(new in 1.6)*

  • Platforms — Native GUI setup for all 13 messaging platforms (Telegram, Discord, Slack, WhatsApp, Signal, Email, Matrix, Mattermost, Feishu, iMessage, Home Assistant, Webhook, CLI). Per-platform forms write credentials to ~/.hermes/.env and behavior toggles to ~/.hermes/config.yaml. WhatsApp and Signal pairing use an inline SwiftTerm terminal for QR scan and signal-cli daemon management
  • Personalities — List defined personalities, pick the active one, and edit SOUL.md inline with markdown preview
  • Quick Commands — Editor for custom /command_name shell shortcuts with dangerous-pattern detection (rm -rf, mkfs, etc.)
  • Credential Pools — Per-provider credential rotation with a fixed OAuth flow (URL extraction + browser open + code paste) and proper --type api-key handling. API keys never stored in UI state — only last-4 preview. Strategy picker (fill_first / round_robin / least_used / random)
  • Plugins — Install via Git URL or owner/repo, update, remove, enable/disable. Reads ~/.hermes/plugins/ directly for reliable state
  • Webhooks — Create, list, test-fire, and remove webhook subscriptions. Detects the "platform not enabled" state and links to gateway setup
  • Profiles — Switch between multiple isolated Hermes instances. Create, rename, delete, export (zip), import. Safe-switch warning reminds users to restart Scarf after activating a different profile
  • Hermes Proxy (new in 2.9, Hermes v0.14+) — Launch the OpenAI-compatible local proxy that forwards requests to your OAuth-authenticated upstream provider (Nous Portal in v0.14; more adapters as Hermes adds them). Status card with running/stopped badge, endpoint URL with copy button (http://127.0.0.1:8645/v1), provider picker, live log tail, and a usage-help card. Point Codex CLI / Aider / Cline / VS Code Continue at the endpoint and any bearer token works — the proxy attaches your real credential

Dashboard Schema Reference

{
  "version": 1,
  "title": "Required — dashboard title",
  "description": "Optional — subtitle text",
  "updatedAt": "Optional — ISO 8601 timestamp",
  "sections": [
    {
      "title": "Section Name",
      "columns": 3,
      "widgets": [{ "type": "...", "title": "..." }]
    }
  ]
}

Each section defines a grid with 1–4 columns. Widgets flow left-to-right, wrapping to new rows. See DASHBOARD_SCHEMA.md for the full schema reference with examples of every widget type.

Troubleshooting remote connections

If the connection pill is green but the Dashboard shows "Stopped", "unknown", or empty values, the SSH user can't read the Hermes state files. Open Manage Servers → 🩺 Run Diagnostics (or click the yellow "Can't read Hermes state" pill in the toolbar). The diagnostics sheet runs fourteen checks in one SSH session — connectivity, sqlite3 presence, read access to config.yaml and state.db, the effective non-login $PATH — and tells you exactly which one fails and why, with remediation hints for each. Use the Copy Full Report button to paste the full output into a bug report.

For the common "Hermes isn't at the default path" case (systemd services, Docker), Test Connection in the Add Server sheet now probes /var/lib/hermes/.hermes, /opt/hermes/.hermes, /home/hermes/.hermes, and /root/.hermes when it can't find state.db at ~/.hermes/, and offers a one-click fill if it finds any of them.

🇨🇳 中文文档镜像 AI 翻译 2026-05-29
英文原文章节由系统翻译为中文摘要，便于快速理解。完整原文见上方 "📑 README 深度解析"。
📌 简介

Scarf 是一款专为 Hermes AI agent 设计的原生 macOS 伴侣应用。它为用户提供了对 Hermes 运行状态的全面可视化能力，让你可以实时监控 Hermes 的执行过程、操作时间以及它所创建的所有内容，确保 AI Agent 的每一个动作都清晰可见、有迹可循。

⚡ 功能介绍

Scarf 的 UI 设计与 Hermes 的侧边栏完全同步，实现了功能的 1:1 映射。通过最新的 v2.9 版本，Scarf 已全面适配 Hermes v0.14.0 的“基础发布版”功能，支持包括 `/subgoal`、`/yolo`、`/sessions` 及 `/codex-runtime` 在内的全新斜杠命令，并集成了 xAI Grok、NovitaAI 等推理提供商以及 Brave Search、DuckDuckGo 等 Web 搜索后端，提供与 OpenAI 兼容的强大体验。

📋 环境依赖

运行 Scarf 需要 macOS 14.6+ (Sonoma) 系统；若需使用 iPhone 伴侣应用 ScarfGo，则需 iOS 18.0+；从源码构建则需 Xcode 16.0+。此外，远程主机必须具备 SSH 访问权限（通过本地 ssh-agent 进行密钥认证，无需手动输入密码），并且 `$PATH` 中必须包含 `sqlite3`，以便进行原子化的数据库快照操作。

🛠 安装步骤（Docker/pip/源码）

你可以通过 ACP 命令快速配置环境：在 Health 视图中点击“Set up browser tools”按钮，即可一键运行 `hermes acp --setup-browser --assume-yes` 来安装 Chromium 并配置 Playwright。若需从源码构建，可以使用 Xcode 打开 `.xcodeproj` 文件，或通过命令行使用 `xcodebuild` 进行编译。对于没有 Apple Developer 账号的贡献者，推荐使用 `./scripts/local-build.sh` 进行本地 Debug 构建。

🚀 使用教程

快速上手指南：首先，在任何项目文件夹中创建 `.scarf/dashboard.json` 文件，用于定义自定义仪表盘的内容。你可以通过 JSON 配置不同的 `sections` 和 `widgets`（如 `stat` 或 `progress` 类型），从而实现对项目状态、测试覆盖率等关键指标的实时可视化监控，让项目进度一目了然。

⚙️ 配置说明（含 MCP / env）

Scarf 支持通过斜杠命令进行高级配置。使用 `/subgoal <text>` 可以为当前的 `/goal` 循环添加额外的成功标准，并支持通过 `remove N` 或 `clear` 进行管理。针对 MCP (Model Context Protocol) 服务，新增了 `supports_parallel_tool_calls` 可选标志，允许在编辑器中通过三态选择器进行配置。此外，`terminal.docker_extra_args` 参数可将额外参数原样转发给 `docker run` 命令。

🔌 API 说明

仪表盘 Schema 参考：Scarf 使用 JSON 格式定义仪表盘。每个 JSON 文件必须包含 `version` 和 `title` 字段，`description` 和 `updatedAt` 为可选字段。`sections` 数组定义了网格布局，每个 section 内可以包含多个 `widgets`，通过配置不同的类型和颜色，实现高度定制化的监控界面。

❓ FAQ 摘要

故障排除：如果连接指示灯显示为绿色，但 Dashboard 却显示“Stopped”、“unknown”或数值为空，通常是因为 SSH 用户缺乏读取 Hermes 状态文件的权限。此时，请前往 Manage Servers → Run Diagnostics，或点击工具栏中的黄色警告提示，运行内置的诊断程序，它将执行 14 项自动化检查以定位问题。

🎯 aiskill88 AI 点评 A 级 2026-05-20

高质量MCP工具实现，原生性能优异。多窗口架构设计合理，活跃维护，502星反映社区认可度良好。

📚 实用指南（长尾问题）
适合谁
  • 需要让 Claude / Cursor 操作本地工具的 AI 工程师
  • 构建多智能体协作系统的 Agent 开发者
  • 做语音类 AI 产品的开发者
最佳实践
  • 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
  • 生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据
  • Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
常见错误
  • API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
  • MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
  • 容器内无法访问宿主机 localhost — 使用 host.docker.internal
部署方案
  • Docker：scarf 提供官方镜像，docker compose up 一键启动
  • CLI：直接 npm install -g / pip install，命令行调用
  • 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
相关搜索
scarf 中文教程scarf 安装报错怎么办scarf MCP 配置scarf Docker 部署scarf Agent 工作流scarf 与同类工具对比scarf 最佳实践scarf 适合谁用

⚡ 核心功能

👥 适合谁
  • 需要让 Claude / Cursor 操作本地工具的 AI 工程师
  • 构建多智能体协作系统的 Agent 开发者
  • 做语音类 AI 产品的开发者
⭐ 最佳实践
  • 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
  • 生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据
  • Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
⚠️ 常见错误
  • API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
  • MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
  • 容器内无法访问宿主机 localhost — 使用 host.docker.internal

👥 适合人群

AI 技术爱好者研究人员和学生开发者和工程师技术创业者

🎯 使用场景

  • 本地部署运行，保护数据隐私，满足合规要求
  • 自定义集成到现有系统，扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发

⚖️ 优点与不足

✅ 优点
  • +MIT 协议，可免费商用
  • +完全开源免费，无授权费用
  • +本地部署，数据完全自主可控
  • +开发者社区支持，遇问题可查可问
⚠️ 不足
  • −安装和初始配置可能需要一定技术基础
  • −功能完整性通常不如成熟商业产品
  • −技术支持主要依赖开源社区，响应速度不稳定
⚠️ 使用须知

AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。

建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。

📄 License 说明

✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。

🔗 相关工具推荐

LlamaIndex 知识检索框架
LlamaIndex是领先的文档智能代理和OCR平台，专为构建AI应用而设计。提供数据连接、检索增强生成（RAG）等核心
AutoGPT 自主AI代理
AI工具
JavaGuide面试指南
AI工具
Hermes AI工作流引擎
AI工具
📚 相关教程推荐
MCP 配置教程
帮助中心 · AI Skill Hub
MCP 工具
帮助中心 · AI Skill Hub
Cursor AI 编程完全指南：Rules 配置、Composer 使用、MCP 集成
帮助中心 · AI Skill Hub
MCP 工作流生产级配置方案：从开发环境到团队共享
帮助中心 · AI Skill Hub
📰 相关 AI 新闻
AI Agent 自主化能力最新进展
AI 资讯 · 知识关联
GitHub热门：claude-mem — Persistent Context Across Sessions for Every Agent – Capt
AI 资讯 · 知识关联
OpenAI 最新产品与研究动态
AI 资讯 · 知识关联
AI Agent 自主化能力最新进展
AI 资讯 · 知识关联
🍿 AI 圈相关吃瓜
AutoGPT 自主完成了任务：把我的文件夹全部重命名了
AI 圈观察
配了5个 MCP 工具，Claude 一个都没用
AI 圈观察
Filesystem MCP 帮 Claude 找文件，找了整个 node_modules
AI 圈观察
🗺️ 相关解决方案
mcp
mcp-server-setup
agent
ai-agent-workflow
workflow
ai-workflow-templates
docker
docker-deploy
🧩 你可能还需要
基于当前 Skill 的能力图谱，自动补全的工具组合
Augustus
LLM安全测试框架，检测prompt注入、越狱等
MemOS智能记忆系统
MCP · Agent · 工作流
natively-cluely-ai-assistant — Claude Skill 中文使用文档
免费开源的AI面试助手，实时转录，隐蔽模式，局部RAG，BYOK。无订阅，防止数据泄露。
CrewAI 多代理协作平台
MCP · Agent · 工作流
gptme Agent工作流
MCP · Agent · 工作流
技能寻求者
MCP · Agent · 工作流

❓ 常见问题 FAQ

支持多服务器连接，兼容Hermes AI代理框架的各类后端服务。
💡 AI Skill Hub 点评

总体来看，scarf MCP工具 是一款质量优秀的AI工具，在同类工具中具备一定竞争力。AI Skill Hub 将持续追踪其更新动态，建议收藏备用，结合自身场景选择合适时机引入使用。

📚 深入学习 scarf MCP工具
查看分步骤安装教程和完整使用指南，快速上手这款工具
⚙️ 安装教程 📚 使用教程
🌐 原始信息
原始名称 scarf
原始描述 开源MCP工具：Native macOS and iOS App for the Hermes AI agent — multi-window, multi-server (l。⭐502 · Swift
Topics MCP工具AI代理macOS应用Swift开发多窗口管理
GitHub https://github.com/awizemann/scarf
License MIT
语言 Swift
🔗 原始来源
🐙 GitHub 仓库  https://github.com/awizemann/scarf 🌐 官方网站  https://awizemann.github.io/scarf/

收录时间：2026-05-16 · 更新时间：2026-05-19 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。

📺 订阅 AI Skill Hub Daily Telegram 频道
每天 8 条精选 AI Skill、MCP、Agent 与自动化工具推送
加入频道 →