# Minions Mission Control

Five autonomous coding agents, one engine, one dashboard. Plan, implement, review, verify, and ship code with human control at every gate.

Node.js 18+ Claude or Copilot Multi-Project Dashboard + CLI
Install from npm Quick Start
🏗️
Ripley
Lead / Explorer
🔧
Dallas
Engineer
📊
Lambert
Analyst
🧠
Rebecca
Architect
⚙️
Ralph
Engineer

### Autonomous Dispatch

Engine discovers work from plans, PRs, schedules, pipelines, and queues — then routes to the right agent by role, skill, and availability.

### Plan Lifecycle

Plan → Approve → PRD → Execute → Review → Verify. Completed plans stay available until you manually archive them.

### Team Meetings

Multi-agent meetings with investigate, debate, and conclude rounds. Agents research, discuss, and produce actionable conclusions.

### Multi-Stage Pipelines

Chain tasks, meetings, plans, and more into automated workflows. Cron triggers or manual. Artifacts flow between stages.

### Review / Fix Loop

After implementation, Minions can dispatch reviews, react to human PR comments, and send fixes back to the original author agent.

### Git Worktree Isolation

Each agent works in its own worktree. No conflicts, no cross-contamination, safe parallel execution.

### Knowledge Consolidation

Agent findings, quick notes, pinned notes, and feedback consolidate into team notes and a categorized knowledge base.

### PR Integration

Tracks Azure DevOps and GitHub PRs, including review votes, build status, merge status, human comments, and context-only links.

### Scheduled Tasks & Watches

Cron-style recurring work plus watches for PRs, work items, dispatches, meetings, pipelines, agents, and status changes.

### Command Center & Doc Chat

Natural language orchestration, persistent CC tabs, document Q&A/editing, issue filing, routing updates, and local API actions.

### Pluggable Runtimes

Run agents through Claude Code or GitHub Copilot CLI, with runtime-specific models, effort, session resume, and permission handling.

### Live Dashboard

Real-time mission control on port 7331 with paginated views, optimistic updates, live streams, metrics, and settings.

### One-Command Updates

`minions update` pulls the latest npm package, reapplies files, and restarts while preserving config and customizations.

1

## Dashboard Overview

Home page with agent status cards, project bar, setup guidance, and engine state. All agents visible at a glance.

Home page showing Minions Members, project bar, and engine status badge
2

## Work Items

Paginated table with status, type, priority, agent, dependencies, artifacts, and linked PRs. PENDING DISPATCHED DONE FAILED. Retry, delete, archive, and add feedback with optimistic updates.

Work items page — 20 per page with create, edit, retry, and delete actions
3

## Plans & PRD

Plan cards with Approve / Discuss & Revise / Reject. PRD dependency graph with per-item retry, reopening, verification, and manual archive.

Plans page with status-colored cards, PRD dependency graph, and action buttons
4

## Pull Requests

PR tracker sorted by date, with review, build, merge, conflict, and human-comment status. Linked to work items and PRD items. Manual PR linking and context-only observation supported.

PRs sorted newest-first with build status, review status, and agent attribution
5

## Team Meetings

Multi-agent meetings with 3 rounds: investigate, debate, conclude. Live progress per participant. Create plans from conclusions.

Meetings with round status badges, participant progress, and archive/delete actions
6

## Pipelines

Multi-stage workflows chaining tasks, meetings, plans, tests, docs, and more. Cron triggers or manual runs. Artifact tracking between stages.

Pipeline cards with stage flow visualization, run history, and progress bars
7

## Notes & Knowledge Base

Inbox for agent findings, quick notes, pinned notes, consolidated team notes, and categorized knowledge base. Inline Q&A/editing on documents.

Notes inbox, team notes, and knowledge base with category tabs and pagination
8

## Scheduled Tasks

Cron-style recurring work with a visual builder. Schedule work items, tests, docs, plans, asks, meetings, and recurring maintenance.

Schedule list with cron expressions, last-run times, and enable/disable toggles
9

## Engine & Metrics

Dispatch queue, engine log, agent metrics, token usage, runtime/model data, quality signals, and context pressure. All paginated.

Active/pending dispatches, completed history, engine log, and per-agent quality metrics
10

## Command Center

Natural language delegation. CC orchestrates — agents implement. Sessions persist across refreshes and tabs; actions can create work, notes, plans, watches, PR links, and issues.

Command Center side panel with conversation history, action execution, and session indicator

## Quick Start

    # Prerequisites: Node.js 18+, Git, and at least one agent runtime
    # Install Claude Code or GitHub Copilot CLI separately, then install Minions
    npm install -g @yemi33/minions

    # Bootstrap ~/.minions/ and scan/link repositories
    minions init

    # Or add a specific project later
    minions add ~/my-project

    # Start engine + dashboard, then open http://localhost:7331
    minions restart --open
    minions dash

    # Give your first task
    minions work "Explore the codebase and document the architecture"

    # Useful operations
    minions status
    minions doctor
    minions config set-cli copilot --model gpt-5.4

    # Update to latest
    minions update

## Architecture

      +-----------------------------------------------------+
      |                  ~/.minions/ (central hub)          |
      |                                                     |
      |   engine.js ---- 10s tick loop ----+                |
      |       |                            |                |
      |   discover work    spawn agents    poll PRs/comments|
      |       |                |              |             |
      |   +-------+    +-------------+   +--------+         |
      |   | Plans |    |  Worktrees  |   | ADO /  |         |
      |   | PRDs  |    |  isolated   |   | GitHub |         |
      |   | Items |    |  per agent  |   +--------+         |
      |   +-------+    +-------------+                      |
      |                                                     |
      |   dashboard.js -- port 7331 -- mission control      |
      |   runtimes/ -- Claude Code or GitHub Copilot CLI    |
      |   meetings/ -- multi-agent discussions              |
      |   pipelines/ -- multi-stage workflows               |
      |   schedules + watches -- recurring/conditional work |
      |   notes.md + knowledge/ -- team memory and KB       |
      +-----------------------------------------------------+