Project: Supernova Frontend
Charter
Graphical front-end dashboard for the Supernova AI Agentic OS — replaces terminal-driven agent invocation with a unified web UI. Built model-agnostic so the LLM provider can change without UI rewrite. Success = Adam can run any existing slash command (/brand, /library, /youtube, /notion) from a button, browse vault state live, and chat against a chosen model — all from localhost:3000.
Scope
- In: Vault read-only via MCP, agent/skill execution via Claude Code CLI, free-form chat via provider-agnostic gateway, cosmic supernova design system, run history, command palette, settings.
- Out (deferred): Multi-user auth, remote deploy, mobile polish, vault graph viz, voice input, bidirectional Notion/Asana writes from UI.
Tech stack
- Next.js 15 (App Router) + TypeScript, standalone repo (NOT inside the vault)
- Tailwind v4 + Framer Motion + tsparticles for cosmic effects
- SQLite (Drizzle ORM) for chat sessions + run logs
- Hybrid agent runtime: Claude Code subprocess (skills) + Vercel AI SDK (chat)
- MCP filesystem server for vault reads
Subfolders
- Agents/ — project-specific agents (none yet)
- Skills/ — project-specific skills (none yet)
- Notes/ — working notes, design iterations, decision log
Architecture spec
- SPEC.md — full architecture, data model, design system, phase plan
Linked context
- CLAUDE — vault router (UI navigates this same map)
- _System/ModelRegistry — model tier defaults (UI surfaces these in dropdown)
- Integrations/NotebookLM — library backend
- Integrations/ClaudeMem — cross-session memory
- Wiki/Log — UI live-tails this
- Wiki/Notes/_active-todos — UI renders this with filters