johan
/
mission-control
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
mission-control/docs/LANDING-PAGE-HANDOFF.md

9.8 KiB
Raw Blame History

Mission Control — Landing Page Handoff

Last updated: 2026-03-07 | Version: 1.3.0 | Branch: fix/refactor (bb5029e)

This document contains all copy, stats, features, and structure needed to build or update the Mission Control landing page. Everything below reflects the current state of the shipped product.

Hero Section

Headline: The Open-Source Dashboard for AI Agent Orchestration

Subheadline: Manage agent fleets, track tasks, monitor costs, and orchestrate workflows — all from a single pane of glass. Zero external dependencies. One pnpm start to run.

CTA: Get Started -> GitHub repo | Live Demo -> demo instance (if available)

Badges:

  • MIT License
  • Next.js 16
  • React 19
  • TypeScript 5.7
  • SQLite (WAL mode)
  • 165 unit tests (Vitest)
  • 295 E2E tests (Playwright)

Hero image: docs/mission-control.jpg (current dashboard screenshot — should be refreshed with latest UI)

Key Stats (above the fold)

Stat Value
Panels 31 feature panels
API routes 98 REST endpoints
Schema migrations 36
Test coverage 165 unit + 295 E2E
Total commits 239+
External dependencies required 0 (SQLite only, no Redis/Postgres/Docker)
Auth methods 3 (session, API key, Google OAuth)
Framework adapters 6 (OpenClaw, CrewAI, LangGraph, AutoGen, Claude SDK, Generic)

Feature Grid

1. Task Board (Kanban)

Six-column kanban (Inbox > Assigned > In Progress > Review > Quality Review > Done) with drag-and-drop, priority levels, assignments, threaded comments, and inline sub-agent spawning. Multi-project support with per-project ticket prefixes (e.g. PA-001).

2. Agent Management

Full lifecycle — register, heartbeat, wake, retire. Redesigned agent detail modal with compact overview, inline model selector, editable sub-agent configuration, and SOUL personality system. Local agent discovery from ~/.agents/, ~/.codex/agents/, ~/.claude/agents/.

3. Real-Time Monitoring

Live activity feed, session inspector, and log viewer with filtering. WebSocket + SSE push updates with smart polling that pauses when you're away. Gateway connection state with live dot indicators.

4. Cost Tracking

Token usage dashboard with per-model breakdowns, trend charts, and cost analysis. Per-agent cost panels with session-level granularity.

5. Quality Gates (Aegis)

Built-in review system that blocks task completion without sign-off. Automated Aegis quality review — scheduler polls review tasks and approves/rejects based on configurable criteria.

6. Recurring Tasks

Natural language scheduling — "every morning at 9am", "every 2 hours". Zero-dependency schedule parser converts to cron. Template-clone pattern spawns dated child tasks (e.g. "Daily Report — Mar 07").

7. Task Dispatch

Scheduler polls assigned tasks and runs agents via CLI. Dispatched tasks link to agent sessions for full traceability.

8. Skills Hub

Browse, install, and manage agent skills from local directories and external registries (ClawdHub, skills.sh). Built-in security scanner checks for prompt injection, credential leaks, data exfiltration, and obfuscated content. Bidirectional disk-DB sync with SHA-256 change detection.

9. Claude Code Integration

  • Session tracking — auto-discovers sessions from ~/.claude/projects/, extracts tokens, model info, costs
  • Task bridge — read-only integration surfaces Claude Code team tasks and configs
  • Direct CLI — connect Claude Code, Codex, or any CLI directly without a gateway

10. Memory Knowledge Graph

Visual knowledge graph for agent memory in gateway mode. Interactive node-edge visualization of agent memory relationships.

11. Agent Messaging (Comms)

Session-threaded inter-agent communication via comms API (a2a:*, coord:*, session:*). Coordinator inbox support with runtime tool-call visibility.

12. Multi-Gateway

Connect to multiple agent gateways simultaneously. OS-level gateway discovery (systemd, Tailscale Serve). Auto-connect with health probes.

13. Framework Adapters

Built-in adapter layer for multi-agent registration: OpenClaw, CrewAI, LangGraph, AutoGen, Claude SDK, and generic fallback. Each normalizes registration, heartbeats, and task reporting.

14. Background Automation

Scheduled tasks for DB backups, stale record cleanup, agent heartbeat monitoring, recurring task spawning, and automated quality reviews.

15. Webhooks & Alerts

Outbound webhooks with delivery history, retry with exponential backoff, circuit breaker, and HMAC-SHA256 signature verification. Configurable alert rules with cooldowns.

16. GitHub Sync

Bidirectional GitHub Issues sync with label and assignee mapping. Full parity sync implementation.

17. Security

  • Ed25519 device identity for gateway handshake
  • scrypt password hashing
  • RBAC (viewer, operator, admin)
  • CSRF origin checks
  • CSP headers
  • Rate limiting with trusted proxy support
  • Per-agent rate limiting with x-agent-name identity-based quotas
  • Skill security scanner

18. Self-Update

GitHub release check with banner notification. One-click admin update (git pull, pnpm install, pnpm build). Dirty working trees rejected. All updates audit-logged.

19. Audit Trail

Complete action type coverage with grouped filters. Full audit history for compliance and debugging.

20. Pipelines & Workflows

Pipeline orchestration with workflow templates. Start, monitor, and manage multi-step agent workflows.

"How It Works" Section

1. Clone & Start       git clone ... && pnpm install && pnpm dev
2. Agents Register     Via gateway, CLI, or self-registration endpoint
3. Tasks Flow          Kanban board with automatic dispatch and quality gates
4. Monitor & Scale     Real-time dashboards, cost tracking, recurring automation

Tech Stack Section

Layer Technology
Framework Next.js 16 (App Router)
UI React 19, Tailwind CSS 3.4
Language TypeScript 5.7
Database SQLite via better-sqlite3 (WAL mode)
State Zustand 5
Charts Recharts 3
Real-time WebSocket + Server-Sent Events
Auth scrypt hashing, session tokens, RBAC
Validation Zod 4
Testing Vitest + Playwright

Auth & Access Section

Three auth methods:

  1. Session cookie — username/password login (7-day expiry)
  2. API key — x-api-key header for headless/agent access
  3. Google Sign-In — OAuth with admin approval workflow

Three roles:

Role Access
Viewer Read-only dashboard access
Operator Read + write (tasks, agents, chat, spawn)
Admin Full access (users, settings, system ops, webhooks)

Architecture Diagram (simplified)

mission-control/
  src/
    app/api/          98 REST API routes
    components/
      panels/         31 feature panels
      dashboard/      Overview dashboard
      chat/           Agent chat workspace
      layout/         NavRail, HeaderBar, LiveFeed
    lib/
      auth.ts         Session + API key + Google OAuth
      db.ts           SQLite (WAL mode, 36 migrations)
      scheduler.ts    Background automation
      websocket.ts    Gateway WebSocket client
      adapters/       6 framework adapters
  .data/              Runtime SQLite DB + token logs

Quick Start Section

git clone https://github.com/builderz-labs/mission-control.git
cd mission-control
pnpm install
cp .env.example .env    # edit with your values
pnpm dev                # http://localhost:3000

Initial login seeded from AUTH_USER / AUTH_PASS on first run.

Social Proof / Traction

  • 239+ commits of active development
  • Open-source MIT license
  • Used in production for multi-agent orchestration
  • Supports 6 agent frameworks out of the box
  • Zero-config SQLite — no Docker, Redis, or Postgres required

Roadmap / Coming Soon

  • Agent-agnostic gateway support (OpenClaw, ZeroClaw, OpenFang, NeoBot, IronClaw, etc.)
  • Flight Deck — native desktop companion app (Tauri v2) with real PTY terminal grid and system tray HUD (private beta)
  • First-class per-agent cost breakdowns panel
  • OAuth approval UI improvements
  • API token rotation UI

Recent Changelog (latest 20 notable changes)

  1. Memory knowledge graph — interactive visualization for agent memory in gateway mode
  2. Agent detail modal redesign — minimal header, compact overview, inline model selector
  3. Spawn/task unification — spawn moved inline to task board, sub-agent config to agent detail
  4. Agent comms hardening — session-threaded messaging with runtime tool visibility
  5. Audit trail — complete action type coverage with grouped filters
  6. OS-level gateway discovery — detect gateways via systemd and Tailscale Serve
  7. GitHub sync — full parity sync with loading state fixes
  8. Automated Aegis quality review — scheduler-driven approve/reject
  9. Task dispatch — scheduler polls and runs agents via CLI with session linking
  10. Natural language recurring tasks — zero-dep schedule parser + template spawning
  11. Claude Code task bridge — read-only team task and config integration
  12. Agent card redesign — gateway badge tooltips, ws:// localhost support
  13. Skills Hub — registry integration, bidirectional sync, security scanner
  14. Per-agent rate limiting — identity-based quotas via x-agent-name
  15. Agent self-registration — autonomous onboarding endpoint
  16. Framework adapters — OpenClaw, CrewAI, LangGraph, AutoGen, Claude SDK, generic
  17. Self-update mechanism — one-click update with audit logging
  18. Local agent discovery — auto-detect from ~/.agents, ~/.codex, ~/.claude
  19. Chat workspace — embedded chat with local session continuation
  20. Ed25519 device identity — secure gateway challenge-response handshake

Footer

MIT License | 2026 Builderz Labs GitHub: github.com/builderz-labs/mission-control