awizemann/scarf

Scarf – Hermes AIエージェント用GUIクライアント (macOS & iOS)

概要 – Scarfは、Hermes AIエージェントプラットフォームにグラフィカルなフロントエンドを提供する、ネイティブなSwift‑UIアプリケーションです。macOS 15+およびiOS 18.6+（コンパニオンアプリのScarfGo）で動作し、SSHを介してHermesサーバーと通信し、エージェントの状態ファイルを読み取り、変更にはhermesCLIを呼び出します。

主な機能

• 完全な可視性 – ダッシュボード、セッション履歴、ツール呼び出しログ、トークン使用量とコストの内訳、検索可能なアクティビティフィード。
• リッチな対話 – Agent Client Protocol (ACP)を介したストリーミングチャット（マークダウン、ツール呼び出しの視覚化、または実際のターミナルビュー）、音声チャット（オンデバイス音声認識とオプションのOpenAI搭載ライブ音声）。
• プロジェクト指向ワークフロー – 各リポジトリがプロジェクトとして表示され、独自のダッシュボード、かんばんボード、cronジョブ、メモリファイル、スキル、テンプレート、ミニアプリを備えています。
• マルチサーバー対応 – システムSSH設定を介して、任意の数のHermesホスト（ローカルの~/.hermes/またはリモートマシン）を管理できます。各サーバーは独自のウィンドウで開きます。
• 設定UI – YAMLファイルを触らずに、Hermes設定、プラットフォーム（Telegram、Discordなど）、モデル（ローカルOllama、LM Studio、vLLM、llama.cpp）、MCPサーバー、ゲートウェイ、cron、シークレット、プラグインなどを編集できます。
• 安全性 – ScarfはHermes SQLiteデータベースを読み取り専用で読み取ります。すべての書き込みアクションは公式のhermesCLIを介して行われ、破損を防ぎます。仲介サービスは不要です。
• クロスプラットフォームコンパニオン – iPhoneのScarfGoはMacのUIをミラーリングし、電話からチャット、メモリ編集、cron実行、プロファイル切り替えができます。SSHキーはデバイス上で生成され、iOSキーチェーンに保存されます。

一般的なワークフロー

1. Scarfをインストールします（公証済みアプリをダウンロードするか、ソースからビルドします）。
2. ファイル → サーバーを開く → 追加でHermesサーバーを追加します（ssh user@hostと同様）。
3. プロジェクトを選択します – UIにはダッシュボード、セッション、cron、メモリ、スキルなどのコックピットが表示されます。
4. エージェントとチャットし、ツールを実行し、メモリファイルを編集するか、音声会話を開始します。
5. 設定ペインを使用して、プラットフォームの追加、モデルの切り替え、MCPサーバーの管理を行います。
6. ログを検査し、診断を実行するか、マシンのフリートにアップデートをプッシュします。

プライバシー – macOSアプリは匿名化された使用イベントのみを送信します（コンテンツ、パス、ホスト名は含まれません）。iOSアプリは何も送信しません。ライブ音声モードでは、ユーザーの同意後にのみオーディオをOpenAIに直接ストリーミングします。

インストール – 事前ビルド済みバイナリは署名され、Sparkleを介して自動更新されます。ソースはXcode 16または提供されているlocal-build.shスクリプトでビルドできます。

対象ユーザー – 自分のマシンでHermes AIエージェントを実行し、YAMLを書いたりターミナルを使用したりせずに、監視、制御、対話するためのネイティブで安全なGUIを希望する開発者またはパワーユーザー。