TL;DR

Hermes Conduit는 Hermes Agent의 네이티브 대시보드에 직접 연결하는 SwiftUI 기반 iOS 클라이언트입니다. 앱은 대시보드 로그인 후 `/api/ws` WebSocket을 통해 세션·프로필·툴 호출·파일 작업을 동기화하므로 데스크톱에서 시작한 대화를 iPhone이나 iPad에서 이어갈 수 있습니다. 음성 입력, 첨부파일, 모델 전환, MCP 서버와 스킬 설정, 인라인 승인, Face ID 잠금 같은 모바일 기능을 제공하지만 iOS 17 이상과 실행 중인 Hermes Agent 인스턴스가 필요합니다. 푸시 알림은 별도 notifier 플러그인과 Push relay를 요구하며, 기본 공유 relay 대신 자체 호스팅도 가능합니다. Hermes Agent를 이미 셀프호스팅하는 사용자라면 모바일 보조 클라이언트로 검토할 만하지만, 독립적인 AI 앱이나 범용 SDK를 찾는 경우에는 대상이 아닙니다.

핵심 포인트

• Hermes Agent 전용 standalone iOS 클라이언트로, SwiftUI와 iOS 17 이상을 기반으로 합니다. 데스크톱과 같은 세션·프로필·기능을 휴대폰에서 공유하며 별도 중계 서버 없이 사용자의 Hermes 대시보드에 직접 연결합니다. 특정 범용 AI 프레임워크가 아니라 Hermes Agent 생태계에 종속된 모바일 앱입니다.
• 앱은 Hermes 대시보드 로그인 페이지에서 인증한 뒤 `/api/ws` WebSocket에 접속하고, 모든 RPC 호출을 대시보드를 통해 전달합니다. `HermesClient.swift`가 WebSocket과 RPC를 맡고 `AppState.swift`가 세션 상태를 관리하며, 기본 대시보드 포트는 9119입니다. 따라서 Hermes Agent 인스턴스와 네이티브 대시보드가 실행 중이어야 하며 WebUI에는 연결되지 않습니다.
• Streaming chat, Markdown, 코드 블록, Mermaid, 파일 첨부, 음성 모드, 모델 전환, 세션 분기와 MCP 서버 설정을 한 앱에 담았습니다. 툴 호출 승인·추론 추적·Face ID 잠금·푸시 알림으로 모바일에서도 Hermes 작업 흐름을 이어갑니다. 푸시 알림은 iOS 백그라운드 연결 제약 때문에 `hermes-conduit-notifier` 플러그인과 공유 또는 자체 Push relay가 추가로 필요합니다.
• 자체 서버와 직접 통신하며 광고·분석·텔레메트리를 사용하지 않고, Cloudflare Access와 Tailscale 연결도 지원합니다. Cloudflare Access용 서비스 토큰은 Keychain에 저장되고 게이트웨이 URL에 묶이며, 인증 요청·WebSocket 핸드셰이크·WebKit fetch에 헤더가 주입됩니다. Hermes Agent를 이미 운영하면서 iPhone·iPad 접근성과 모바일 승인 기능이 필요한 개발자에게 적합하고, Hermes Agent 없이 단독으로 쓸 수 없는 점은 도입 장벽입니다.