Hermes Swift Mac — Hermes Agent Native macOS Desktop App

Hermes Agent의 네이티브 macOS 데스크톱 앱. Swift + WKWebView로 만들어져 Electron의 오버헤드 없음. Xcode Command Line Tools만 필요.

Overview

• Repository: hermes-webui/hermes-swift-mac
• Language: Swift (89.7%)
• Latest Release: v1.4.1 (April 2026)
• Compatibility: macOS 12 (Monterey) or later
• Web UI Required: Hermes Web UI (nesquena/hermes-webui) running locally or remotely

Installation

Option 1: DMG (Recommended)

Download Hermes-Agent-vX.X.X.dmg from Releases. Signed and notarized by Apple (Gatekeeper 통과).

Option 2: Build from Source

git clone https://github.com/hermes-webui/hermes-swift-mac.git
cd hermmes-swift-mac
./build.sh

Requires Xcode Command Line Tools (xcode-select --install).

Connection Modes

Mode	Description
Direct	Connects to local instance (default: http://localhost:8787)
SSH Tunnel	Connects to remote server via SSH key auth

SSH Tunnel Config

1. Ensure ssh user@your-server works without password
2. Preferences (⌘,) → Connection Mode → SSH Tunnel
3. Set Username, Host, Local Port, Remote Port
4. App automatically manages tunnel lifecycle (opens on launch, closes on quit)

Security: Uses StrictHostKeyChecking=accept-new + ExitOnForwardFailure=yes

Key Features

• Native Performance: Electron 대비 낮은 리소스 사용, 표준 메뉴바 + Dock 아이콘
• Global Shortcut: ⌘⇧H — 어떤 앱에서든 Hermes를 앞으로 가져옴
• Clipboard & Files: 텍스트/이미지 붙여넣기 (⌘V), 파일 업로드 (클립 버튼)
• Notifications: 백그라운드 AI 응답 완료 시 macOS 시스템 알림
• Voice Input: 마이크 통합 (시스템 권한 필요)
• Auto-Updates: Sparkle updater内置
• Smart Links: 외부 링크는 Safari에서 자동 열기

Keyboard Shortcuts

Shortcut	Action
⌘ ,	Preferences 열기
⌘⇧H	Global Shortcut — 앱을 앞으로
⌘R	WebUI 새로고침
⌘W	창 숨기기 (앱은 계속 실행)
⌘+/⌘-	확대/축소
⌘0	줌 리셋

Architecture

• main.swift: Entry point + signal handling
• AppDelegate.swift: Lifecycle + Sparkle updater
• BrowserWindowController.swift: WKWebView + notifications 관리
• TunnelManager.swift: SSH process management + port probing
• PreferencesWindowController.swift: Settings UI + connection testing

Troubleshooting

• Connection Error: Hermes Web UI 실행 중인지 확인 (bash start.sh)
• SSH Disconnects: Terminal에서 SSH 키 인증 동작하는지 확인
• Voice Input Fails: System Settings → Privacy & Security → Microphone에서 Hermes Agent 활성화
• Blurry Icon (Source Build): killall Dock 실행으로 macOS 아이콘 캐시 리프레시

Sources

• hermes-webui/hermes-swift-mac — GitHub