awizemann/scarf

Scarf – Hermes AI 에이전트용 GUI 클라이언트 (macOS & iOS)

개요 – Scarf는 Hermes AI 에이전트 플랫폼에 그래픽 프런트엔드를 제공하는 네이티브 Swift‑UI 애플리케이션입니다. macOS 15+ 및 iOS 18.6+ (동반 앱 ScarfGo)에서 실행되며, 일반 SSH를 통해 Hermes 서버와 통신하여 에이전트의 상태 파일을 읽고 변경 사항에 대해 hermes CLI를 호출합니다.

주요 기능

• 완전한 가시성 – 대시보드, 세션 기록, 도구 호출 로그, 토큰 사용량 및 비용 분석, 검색 가능한 활동 피드.
• 풍부한 상호 작용 – 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 데이터베이스를 읽기 전용으로 읽습니다. 모든 쓰기 작업은 공식 hermes CLI를 통해 이루어지며 손상을 방지합니다. 중개 서비스가 필요 없습니다.
• 크로스 플랫폼 동반 앱 – 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를 원하는 개발자 또는 파워 유저.