mission-control README

The project's README from github.com/builderz-labs/mission-control. As one markdown file: README.md.

Mission Control

Self-hosted control plane for operating AI agents.

Dispatch tasks, inspect runs, review failures, track spend, and coordinate agent runtimes from one local dashboard backed by SQLite.

An open-source project by Builderz Labs, created and maintained by nyk. It works with OpenClaw, Claude Code, Codex, and other runtimes - it is not part of any one of them.

Quality Gate Release License: MIT Sponsor

Mission Control overview dashboard with active sessions, live activity, fleet status per runtime, and the task pipeline

[!WARNING] Mission Control is alpha software. APIs, schemas, and configuration may change between releases. Read the security guidance before exposing it to a network.

Start locally

Node.js 22 or newer and pnpm are required for a source install.

git clone https://github.com/builderz-labs/mission-control.git
cd mission-control
bash install.sh --local

Open http://localhost:3000/setup, create the first admin account, then copy the API key from Settings if an agent or script needs headless access.

The manual path is useful when you already manage Node and pnpm:

nvm use 22
pnpm install
pnpm dev

Windows users can run ./install.ps1 -Mode local in PowerShell.

Start with Docker

docker compose up

Or run the published multi-architecture image:

docker pull ghcr.io/builderz-labs/mission-control:latest
docker run --rm -p 3000:3000 ghcr.io/builderz-labs/mission-control:latest

Use the hardened Compose overlay for a network-accessible deployment:

docker compose -f docker-compose.yml -f docker-compose.hardened.yml up -d

The deployment guide covers persistent data, TLS termination, gateway connectivity, and standalone builds.

What Mission Control governs

The control plane sits above agent runtimes. It does not replace their reasoning or tool loops. It gives operators one place to see and govern the work around those loops.

Area Shipped surface
Tasks Inbox, assignment, execution, review, Aegis quality gate, and completion receipts
Agents Registration, presence, sessions, runtime adapters, configuration, and workspace sync
Operations Activity stream, schedules, alerts, webhooks, logs, token use, and cost views
Knowledge Memory browser, relationship graph, skills registry, and local skill synchronization
Governance Roles, API keys, security events, trust signals, approvals, audits, and evals
Interfaces Web UI, CLI, MCP server, OpenAPI-described REST API, WebSocket, and SSE

The runtime is self-hosted and workspace-aware. SQLite stores local control-plane state. Shared workspaces can use deployment-level runtime integrations. Strict workspaces block those integrations until the underlying resources carry workspace ownership. A gateway is optional for task, project, agent, scheduler, webhook, alert, and cost work; live session messaging needs a connected runtime gateway.

Operator field notes

Dashboards compress a sequence into current state. When a run needs review, record the identity, task, tool call, approval, result, and verification evidence before changing it. Keep unresolved items distinct from accepted risk.

Mission Control operator field notes

Logs show what ran. A completion receipt or inspected artifact shows what finished.

Pick the right fit

Use Mission Control when multiple agents or runtimes make it hard to answer who owns a task, what executed, which result passed review, or where spend and failures accumulated.

It is probably the wrong tool when:

Adapters and observation surfaces cover OpenClaw, Claude Code, Codex, CrewAI, LangGraph, AutoGen, and Claude SDK workflows. Adapter depth varies by runtime; see agent setup and CLI integration before assuming feature parity.

Connect an agent

The shortest gateway-free loop uses the REST API. Export the URL and API key shown in Settings:

export MC_URL=http://localhost:3000
export MC_API_KEY=replace-with-your-api-key

Register an agent and create work:

curl -s -X POST "$MC_URL/api/agents/register" \
  -H "Authorization: Bearer $MC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"scout","role":"researcher"}'

curl -s -X POST "$MC_URL/api/tasks" \
  -H "Authorization: Bearer $MC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Review open incidents","assigned_to":"scout","priority":"medium"}'

The agent can then claim its queue:

curl -s "$MC_URL/api/tasks/queue?agent=scout" \
  -H "Authorization: Bearer $MC_API_KEY"

Continue with the first-agent quickstart for heartbeats, task results, queue behavior, CLI equivalents, and MCP setup.

CLI

pnpm mc agents list --json
pnpm mc tasks queue --agent scout --json
pnpm mc events watch --types agent,task

MCP server

claude mcp add mission-control -- \
  env MC_URL=http://127.0.0.1:3000 MC_API_KEY=replace-with-your-api-key \
  node /absolute/path/to/mission-control/scripts/mc-mcp-server.cjs

Use the CLI and MCP reference for the current command and tool surface. The REST contract lives in openapi.json. A running instance serves the interactive reference at /docs and the OpenAPI JSON at /api/docs.

Product surfaces

Tasks and quality review

The task board tracks work through inbox, assignment, execution, review, quality review, and completion. Aegis review requires an approval record before a task reaches done.

Mission Control task board with assigned, in-progress, and review columns of agent tasks

Agents and runtimes

Agent views combine registration state, heartbeats, sessions, configuration, local runtime discovery, and workspace files.

Mission Control agents panel showing a five-agent squad with roles, heartbeats, and workspace conventions

Memory and skills

The memory browser and relationship graph inspect filesystem-backed memory and linked session knowledge. The Skills Hub discovers local skill roots and scans registry content before installation.

Mission Control memory browser rendering a markdown agent note with wiki-style links between memory files

Schedules and activity

Recurring task templates create dated work on a cron schedule. The activity stream combines agent, task, and system events for operator review.

Mission Control cron management calendar with scheduled jobs across the week

Mission Control activity stream with per-agent status and heartbeat events

Documentation

Guide Use it for
Quickstart Register an agent and run the first task loop
Agent setup Sources, identities, SOUL files, and heartbeats
Orchestration Dispatch, handoffs, workflows, and review gates
CLI and MCP Headless commands and agent tools
CLI integration Claude Code, Codex, and gateway-free connections
Deployment Local, Docker, standalone, reverse proxy, and VPS setup
Security hardening Network, container, CSP, and secret controls
Support Questions, bugs, feature proposals, and security-report routing
OpenClaw compatibility Config and state-directory behavior
Release process Versioning, tags, images, and release checks

Architecture

Web UI ─┐
CLI ────┼── auth ─ dispatch ─ events ─ policy ─ receipts
MCP ────┤                                      │
REST ───┘                         SQLite + agent runtimes
Layer Technology
Application Next.js 16 App Router, React 19, TypeScript 5
Interface Tailwind CSS 4, Zustand, Recharts, xterm.js
State SQLite through better-sqlite3, with WAL mode
Boundaries REST/OpenAPI, MCP, CLI, WebSocket, and SSE
Access Session cookies, API keys, Google sign-in, and role checks
Validation Zod at input boundaries
Verification Vitest, Playwright, ESLint, TypeScript, build, and API parity checks

Runtime data defaults to .data/. Set MISSION_CONTROL_DATA_DIR to an absolute persistent path for standalone deployments. The complete environment contract is in .env.example.

Security boundary

Access controls and security inspection surfaces are included, but alpha status still applies. Read SECURITY-HARDENING.md before relying on a network-accessible deployment.

Develop

pnpm install --frozen-lockfile
pnpm lint
pnpm typecheck
pnpm test
pnpm build
pnpm test:e2e

pnpm quality:gate runs the full repository gate. Useful diagnostics:

bash scripts/station-doctor.sh
bash scripts/security-audit.sh
pnpm api:parity

Common local failures:

Symptom Check
Login returns an internal error after changing Node versions Run pnpm rebuild better-sqlite3
Docker cannot reach the gateway Set OPENCLAW_GATEWAY_HOST=host.docker.internal
Browser WebSocket cannot connect Leave NEXT_PUBLIC_GATEWAY_HOST empty or set a browser-reachable host
Password text after # disappears Quote AUTH_PASS or use AUTH_PASS_B64

See CONTRIBUTING.md for contribution scope, coding standards, and review expectations. Community conduct is defined in CODE_OF_CONDUCT.md.

Project status and support

Release notes live in CHANGELOG.md. Open issues are the current roadmap; the project does not promise dates for unassigned work.

Mission Control star history

License

MIT © 2026 Builderz Labs

mission-control (builderz-labs/mission-control)

Searching Database…

6.4K ·GitHub
Mission-control
Что это такое?Mission Control — это самостоятельно размещаемая система управления ИИ-агентами для написания кода. Она распределяет задачи, проверяет запуски, отслеживает расходы и координирует такие среды выполнения, как OpenClaw, Claude Code и Codex, из одной локальной панели на базе SQLite.
Это фреймворк для агентов или слой мониторинга и эксплуатации?Это не фреймворк для агентов. Он работает поверх существующих сред выполнения агентов и не заменяет их логику рассуждений и цикл вызова инструментов, а даёт операторам одно место, где можно видеть и контролировать работу этих агентов.
Как его запустить?Для установки из исходников установите Node.js 22+ и pnpm (пользователи Windows могут выполнить './install.ps1 -Mode local' в PowerShell). Либо загрузите опубликованный мультиархитектурный Docker-образ и используйте защищённый Compose-оверлей для развёртывания с сетевым доступом.
Какие среды выполнения агентов поддерживаются на самом деле?Адаптеры и средства наблюдения охватывают OpenClaw, Claude Code, Codex, CrewAI, LangGraph, AutoGen и рабочие процессы Claude SDK, однако глубина поддержки адаптеров зависит от конкретной среды выполнения.
Достаточно ли он стабилен для продакшена?Нет. Проект прямо помечен как альфа-версия: API, схемы и конфигурация могут меняться между релизами. Перед открытием доступа к сети рекомендуется прочитать руководство по безопасности.
Когда этот инструмент не подходит?Не берите его, если одним агентом на одной машине и так легко управлять через его родной CLI, если нужен управляемый многопользовательский SaaS вместо самостоятельного размещения, если хотите, чтобы планированием и использованием инструментов занимался фреймворк для агентов, или если ваше развёртывание не может выдержать изменения схем альфа-уровня.
Остаются ли данные моих агентов локально?Состояние среды выполнения хранится локально в SQLite (по умолчанию в .data/). Проект предупреждает, что экземпляр нужно держать в доверенной сети, если не настроены обратный прокси с TLS и список разрешённых хостов.
Как подключить агента к Mission Control?Возьмите URL панели и API-ключ в разделе «Настройки», зарегистрируйте агента и создавайте работу через REST API, затем пусть агент получит свою очередь задач. Для этого цикла задач и API шлюз не нужен.
Что такое Aegis?Aegis — встроенный механизм контроля качества задач в Mission Control. Он требует запись об одобрении, прежде чем задачу можно будет отметить как выполненную, и стоит между выполнением и завершением.
Какой стек технологий лежит в основе панели?Панель построена на Next.js 16 с React 19 и TypeScript 5, стилизована с помощью Tailwind CSS 4. Для состояния используется Zustand, для графиков — Recharts, для окон терминала — xterm.js, а для хранения — better-sqlite3 в режиме WAL.
Нужен ли подключённый шлюз, чтобы пользоваться им?В основном нет. Шлюз необязателен для работы с задачами, проектами, агентами, планировщиком, вебхуками, оповещениями и расходами, но для живого обмена сообщениями со средой выполнения нужен подключённый шлюз.
What are similar projects?paperclip, evenfire, tinyagi, ordewell, turnstone, ruflo, vicoa, openrig
Which topics is it in?agent-observability, sse, task-management, openapi, openclaw, oauth, github-actions, tui, websocket, ci, orchestration, agent-orchestration
Creator
builderz-labs
Size
19 MB
Stars
6.4K
Updated
CommitSep 22Releasev2.3.0Jul 25
Age
8mo
Commits · 90 Days