Skip to content

Getting Started

Jump to bottom
Nyk edited this page Mar 6, 2026 · 1 revision

Getting Started

Last reviewed: 2026-03-06 Owner: core maintainers

Use this page for first-time local setup and first successful workflow check.

Prerequisites

  • Node.js 20+
  • pnpm (corepack enable)
  • Git

Local Setup

git clone https://github.com/builderz-labs/mission-control.git
cd mission-control
pnpm install
cp .env.example .env
pnpm dev

Open http://localhost:3000.

First Login

  • On first run, login credentials are seeded from AUTH_USER and AUTH_PASS.
  • If password includes #, quote it in env files:
    • AUTH_PASS="my#password"
    • or use AUTH_PASS_B64.

First 10-Minute Validation

  1. Login via /login.
  2. Confirm dashboard loads without API errors.
  3. Create one task in board.
  4. Confirm task appears in task list.
  5. Confirm /api/status returns healthy response.

Connect a CLI Agent (No Gateway)

Register:

curl -X POST http://localhost:3000/api/connect \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "tool_name": "codex",
    "tool_version": "1.0.0",
    "agent_name": "local-agent",
    "agent_role": "developer"
  }'

Send heartbeat (replace IDs):

curl -X POST http://localhost:3000/api/agents/AGENT_ID/heartbeat \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"connection_id":"YOUR_CONNECTION_ID"}'

Exit Criteria

  • UI accessible and authenticated.
  • Task CRUD works.
  • Agent connection works via direct CLI API.
  • No startup errors in server logs.

Clone this wiki locally