249 lines
9.8 KiB
Markdown
249 lines
9.8 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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
|