hermes-mobile/docs/ROADMAP.md

Roadmap

Phase 0 — Planning Scaffold

Status: completed.

Deliverables:

• Repo created
• Product plan
• Architecture plan
• Design direction
• Install strategy
• Project structure

Phase 1 — Skeleton

Goal: empty but runnable monorepo.

Status: in progress.

Deliverables:

• pnpm workspace
• apps/mobile Vite React app with Capacitor Android target and PWA fallback
• apps/companion Fastify server
• shared TypeScript package for event/API schemas
• basic app shell with bottom nav
• /api/health
• local dev scripts

Phase 2 — Basic Hermes Prompting

Goal: phone can send text prompt and receive final answer.

Deliverables:

• pairing/auth MVP
• Settings connect flow
• task creation endpoint
• Hermes CLI/API adapter MVP
• Ask screen sends prompt
• response display
• task history in SQLite

Phase 3 — Realtime Activity + Tool Timeline

Goal: see Hermes work live.

Deliverables:

• event bus
• WebSocket/SSE stream
• tool timeline UI
• Python worker adapter using AIAgent callbacks if needed
• coarse/fine tool event mapping

Phase 4 — Uploads + Voice

Goal: prompt with files and voice notes.

Deliverables:

• multipart upload endpoint
• upload tray UI
• image/archive/pdf metadata
• voice recorder UI
• local STT or Hermes STT bridge
• attach files to task prompt

Phase 5 — Notifications

Goal: close phone and get told when done.

Deliverables:

• Native Android push path or ntfy/Web Push fallback
• PWA service worker fallback
• notification provider abstraction
• notification permission onboarding
• completion/failure/approval notifications

Phase 6 — Cron + Approvals

Goal: mobile control plane.

Deliverables:

• cron list/run/pause/resume/remove
• cron output viewer
• approval queue UI
• companion approval API
• Hermes approval integration strategy

Phase 7 — Installer + Release

Goal: one-liner install.

Deliverables:

• production build
• install.sh
• systemd service
• update/uninstall modes
• release artifact
• pairing URL output

Phase 8 — Android Polish

Goal: feels native.

Deliverables:

• refined Happy-inspired UI
• animations/microinteractions
• Capacitor Android build pipeline
• adaptive icons/splash
• native status/navigation bars
• share target
• haptics
• offline shell polish
• APK release/signing flow

Phase 9 — Deep Hermes Integration

Goal: full Hermes-native experience.

Deliverables:

• structured event stream from Hermes core or stable Python adapter
• richer session browsing
• generated file detection
• background process control
• subagent visualization
• memory/skills dashboards possibly

Open Feature Ideas

• Quick action tiles: “Check homelab”, “Run DV status”, “Start coding task”.
• Voice-to-voice mode.
• Per-task model/toolset selection.
• “Watch mode” for long-running coding tasks.
• Home Assistant widgets/actions.
• Secure notification actions: approve/deny from notification.
• Android native share target.
• QR pairing from terminal output.