Back to Works
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.

JARVIS - Personal AI Operating System

Tech Stack

TypeScriptNext.jsFastifyPostgreSQLZodPlaywrightReact Three FiberSSE

Year

2026.02 - Present

Executive Summary

The Challenge

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.

The Solution

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.

Verified Impact

A public source repository is available, including backend/frontend code, route contracts, and end-to-end test artifacts.

Proof

Technical Documentation

Methodology & Implementation

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