Problem
The live preview feature — viewing the project in a webview with hot module replacement (HMR) — is a work-in-progress. Backend infrastructure exists but isn't fully connected:
backend/omoi_os/services/preview_manager.py — PreviewManager service exists
backend/omoi_os/models/preview_session.py — PreviewSession model exists
- Frontend webview component status unknown
What needs to happen
- Backend: Wire
PreviewManager into the API server lifecycle
- Frontend: Create/complete the webview component that embeds the live preview iframe
- HMR integration: Connect sandbox file changes to HMR updates in the preview
- WebSocket: Stream file change events to trigger preview refreshes
Context
This feature lets users see their project running live while agents make changes — the key differentiation for OmoiOS's "watch agents work" value prop.
Difficulty: Hard | Skill: Full-stack (FastAPI + Next.js + WebSocket)
Problem
The live preview feature — viewing the project in a webview with hot module replacement (HMR) — is a work-in-progress. Backend infrastructure exists but isn't fully connected:
backend/omoi_os/services/preview_manager.py— PreviewManager service existsbackend/omoi_os/models/preview_session.py— PreviewSession model existsWhat needs to happen
PreviewManagerinto the API server lifecycleContext
This feature lets users see their project running live while agents make changes — the key differentiation for OmoiOS's "watch agents work" value prop.
Difficulty: Hard | Skill: Full-stack (FastAPI + Next.js + WebSocket)