JARVIS - Personal AI Operating System

Cognitive / Agent Operating System

JARVIS - Personal AI Operating System

Solo-built personal AI operating system with a Fastify orchestration backend and a Next.js HUD interface. Handles provider routing, missions/councils/executions, approvals, workspaces, memory, watchers, and dogfood-tested operational widgets.

Role
Solo builder · architecture, implementation, and operational tooling
Period
2026.02 - Present
Context
Personal Project
01 / Executive summary

Solo-built personal AI operating system with a Fastify orchestration backend and a Next.js HUD interface. Handles provider routing, missions/councils/executions, approvals, workspaces, memory, watchers, and dogfood-tested operational widgets.

DECISION / ASystem challenge

What made the system difficult.

Needed a single product surface that can route ambiguous user requests into research, code, approval, and automation flows while keeping role gates, streaming state, provider fallback, and workspace execution understandable and operable.

DECISION / BEngineering response

How boundaries and flows answered it.

Implemented a Fastify backend with typed route modules, auth/role enforcement, rate limits, SSE streams, provider registry/policies, missions/councils/executions, and workspace PTY endpoints. Built a modular Next.js HUD with a visual core, widget routing, OpenAPI-synced client types, and Playwright-backed dogfood coverage.

02 / System path

The path of responsibility through the system.

01

Orchestrator Backend

API & Workflow Core

Responsibilities

  • Missions/councils/executions routes
  • Provider routing and policies
  • Role-gated approvals and workspaces
02

HUD Frontend

Operator Interface

Responsibilities

  • Visual core + modular widgets
  • Workspace and approval surfaces
  • Mission-focused navigation
03

Quality Loop

Verification & Dogfood

Responsibilities

  • OpenAPI-generated client types
  • E2E smoke coverage
  • Dogfood reports with screenshot evidence
03 / Technology field
01TypeScript02Next.js03Fastify04PostgreSQL05Zod06Playwright07React Three Fiber08SSE
04 / Detailed record

Overview

  • Solo-built personal AI operating system that combines an orchestration backend with a HUD-style operator interface.
  • The system is organized around task routing, approval gates, provider control, workspace execution, and evidence-oriented UI modules.

Backend Surface

Orchestration API

  • Fastify route modules for auth, providers, assistant contexts, missions, councils, executions, workspaces, memory, approvals, reports, radar, upgrades, and Jarvis session flows
  • Role-gated auth/session handling, rate limiting, raw-body parsing, and error normalization
  • SSE/event endpoints for mission, council, execution, assistant, dashboard, and notification updates

Runtime & Policy Controls

  • Provider routing policies, credential resolution, registry refresh, and token/health workers
  • Workspace runtime endpoints for PTY spawn/write/read and shutdown
  • Approval-gated high-risk actions with notification delivery channels

Frontend Surface

HUD Interface

  • Next.js app with a modular widget shell (Inbox, Assistant, Council, Workbench, Tasks, Reports, Watchers, Dossier, Notifications, Skills, Approvals, Memory, Settings, Model Control, Ideation)
  • Visual core page with deterministic engine controls and scene switching
  • Deep-linkable workspace routes for core, studio, mission, tasks, approvals, automations, settings, and reports

Typed Client Integration

  • OpenAPI-generated frontend types synced from the backend contract
  • Client endpoint layer for typed requests/responses across widgets and workflows

Quality Loop

  • Playwright smoke coverage for core visibility, HUD intake autoplay, council traces, session restore, and auth/settings flows
  • Dogfood reports with screenshot evidence and issue validation artifacts stored inside the repository
  • Public GitHub repository available for direct review of code and verification assets
05 / Factual evidence
JARVIS - Personal AI Operating System project evidence
ACTUAL PROJECT ASSET / NOT GENERATED