Hermes Work

모바일과 PC 어디서든 AI 에이전트의 작업 흐름을 한곳에서 추적하고, 대화·실행 로그·승인·결과물을 작업 단위로 관리하는 Hermes Work입니다.

현재 구현은 Web/PWA 기반 MVP입니다. 최종 제품 목표는 웹만이 아니라 Windows / Android / iOS 설치형 앱까지 포함하는 크로스 플랫폼 애플리케이션입니다. 플랫폼별 계획은 docs/platform-app-plan.md를 기준으로 합니다.

기능

• 세션 중심 보드: 진행중 / 승인 대기 / 실패 / 완료 상태 집계
• 워크스페이스 분리: TSR, ComfyUI, Hermes 운영, Research
• 세션 상세 패널: Hermes 대화내역 조회와 같은 세션에 이어서 프롬프트 전송
• 새 세션 시작: POST /api/sessions로 Hermes 세션 생성 후 즉시 채팅 패널로 이동
• dev server가 ~/.hermes/.env의 API_SERVER_HOST, API_SERVER_PORT를 읽어 현재 Hermes gateway 위치로 proxy 연결
• Hermes API 장애 시 mock fallback으로 오프라인 데모 가능
• Web/PWA manifest 포함: 브라우저에서 설치형 앱처럼 사용 가능
• Windows Tauri v2 shell scaffold 포함: 기존 dist를 desktop webview에 탑재하고 tray proof point 제공
• Android/iOS Capacitor shell scaffold 포함: 기존 dist를 mobile webview에 탑재하고 Android debug APK build 검증
• 의존성 없는 정적 웹 앱: npm install 없이 테스트/빌드 가능

플랫폼 목표

플랫폼	목표 형태	우선 기능
Web/PWA	현재 MVP, 빠른 내부 배포/검증	session list, chat, new session, browser smoke
Windows	Tauri v2 우선 검토	tray, OS notification, local Hermes gateway companion, deep link
Android	Capacitor 우선 검토	push notification, secure storage, share intent, mobile session UX
iOS	Capacitor 우선 검토	APNs/share sheet, secure keychain, mobile session UX

실행

Hermes fork 안의 submodule 위치에서 실행하는 기준:

cd /home/ml/.hermes/hermes-agent/apps/hermes-work
npm test
npm run build
npm run dev
# http://127.0.0.1:5173

Desktop shell 검증:

cargo check --manifest-path src-tauri/Cargo.toml
cargo build --manifest-path src-tauri/Cargo.toml
npm run desktop        # requires cargo-tauri CLI
npm run desktop:build  # requires cargo-tauri CLI; Windows installer는 Windows host/CI에서 검증

Mobile shell 검증:

npm install
npm run build
npm run mobile         # Capacitor sync for android/ios
npm run mobile:doctor  # WSL에서는 Xcode 없음으로 non-zero 가능; Android 상태는 출력됨

# Android debug APK build, requires Android SDK + JDK 21
export ANDROID_HOME=/home/ml/Android/Sdk
export ANDROID_SDK_ROOT=/home/ml/Android/Sdk
cd android
./gradlew assembleDebug

독립 checkout을 쓰는 경우:

cd /home/ml/hermes-work
npm run dev

Hermes API Server 연결

Hermes 쪽 예시 설정 (~/.hermes/.env):

API_SERVER_ENABLED=true
API_SERVER_KEY=<긴 랜덤 키>
API_SERVER_HOST=127.0.0.1
API_SERVER_PORT=8642
API_SERVER_MODEL_NAME=hermes-agent
hermes gateway restart

앱 dev server는 시작 시 ~/.hermes/.env에서 gateway host/port만 읽습니다. API_SERVER_KEY는 읽거나 proxy에 자동 주입하지 않습니다. 즉 /hermes/*는 현재 실행 중인 Hermes gateway로 그대로 전달됩니다.

기본 연결:

• Base URL: /hermes
• Session Key: web:jihun:hermes-work
• API key는 UI/dev server에 저장하거나 자동 주입하지 않음. local companion은 Hermes gateway의 loopback 정책으로 처리.

다른 Hermes API gateway에 붙이고 싶으면 실행 시 환경변수로 target을 지정할 수 있습니다.

HERMES_API_TARGET=http://127.0.0.1:8642 npm run dev

구조

src/domain/taskUtils.mjs       # 작업 필터/카운트/시간 표시
src/services/hermesApi.mjs     # Hermes API Server client + mock fallback
src/ui/renderApp.mjs           # 정적 HTML renderer
src/main.mjs                   # browser state/binding
src/mocks/mockData.mjs         # 데모 task data
scripts/build.mjs              # dist 생성
scripts/dev-server.mjs         # zero-dependency local server + Hermes gateway proxy
tests/*.test.mjs               # node:test 기반 테스트
docs/platform-app-plan.md      # Windows/Android/iOS 설치형 앱 전환 계획
docs/windows-tauri-spike.md    # Tauri desktop shell spike 결과와 남은 Windows 검증
docs/mobile-capacitor-spike.md # Capacitor mobile shell spike 결과와 Android/iOS 검증 상태
src-tauri/                     # Tauri v2 desktop shell scaffold
android/                       # Capacitor Android native project scaffold
ios/                           # Capacitor iOS native project scaffold
capacitor.config.json          # Capacitor Android/iOS shell config