Command Center OS

A local-first operations console — one dashboard for your projects, tasks, goals, an agent-assignment queue, and more, backed by a plain-JSON file database and updated live as files change on disk.

It's built on one core idea: a UI and an agent (e.g. Claude Code) write the same files. Edit a record on disk and it appears in the console instantly (a chokidar watcher streams SSE events); act in the console and the JSON on disk updates. No database server, no build step for content.

This is a public template. It ships with fictional demo data ("Northwind Labs") so every module renders on first run — swap data/ for your own, or run npm run seed to regenerate the demo set.

Quick start

npm install
npm run dev          # http://localhost:3000

No environment variables are required — the app boots open. Optionally copy .env.local.example → .env.local to point the Skills module at a folder of markdown skills (SKILLS_DIR) or to enable a login gate (AUTH_TOKEN, empty = disabled).

What's inside

• Module system — every feature is a self-contained folder under src/modules/<id>/ plus one line in src/modules/registry.ts. Add one with the /new-module skill or by hand (see CLAUDE.md).
• File database (fsdb) — src/lib/fsdb.ts: one pretty-printed JSON file per record, collections are directories under data/, writes are atomic (temp file → rename) so readers never see a half-written file.
• Live updates — a singleton chokidar watcher (src/lib/watcher.ts) → an SSE endpoint (src/app/api/events/route.ts) → one shared EventSource on the client. The LINK · LIVE indicator in the status bar reflects it.
• Assignment queue — a staged work queue (inbox → active → review → done) with a review → done gate only a human can cross. Agents claim from inbox, do the work, and close to review; you accept in the console.
• App shell — sidebar, topbar, status bar, command palette (Ctrl+K), and a boot sequence.

Modules

Overview · Projects · Tasks · Assignments · Goals · Learning · Tools · Knowledge · Architectures · Brain (force-graph) · Briefing · Activity · Skills.

Stack

Next.js 16 · React 19 · TypeScript · Tailwind v4 · chokidar · d3-force · react-markdown. No database, no external services.

Data model

Every record type, its fields, and the assignment state machine are documented in docs/data-contracts.md.

---

Built as a template from a personal build by Ian Provencher.