minions_project.bmp - Paint
PROJECT FILE 01 / AGENTIC SYSTEMS

MinionsMission 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
01 / MEET THE TEAM

Five agents. One mission.

your new coworkers ↘
01
Ripley
Lead / Explorer
02
Dallas
Engineer
03
Lambert
Analyst
04
Rebecca
Architect
05
Ralph
Engineer
02 / INSIDE THE TOOLBOX

More than a chat window.

built to do the work.

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.

03 / A LOOK AROUND

Mission control, in pixels.

real screens. real work. ↘

Ten views into the team’s day. Open any screenshot at full size, or expand a recorded walkthrough to see it in motion.

1

Dashboard Overview

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

01_dashboard.pngOpen full size ↗
Dashboard overview with agent cards
Home page showing Minions Members, project bar, and engine status badge
Play dashboard walkthrough GIF
Animated tour of the Minions dashboard and agent status cards

Collapse to hide the animation. Open recording at full size ↗

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.

02_work_items.pngOpen full size ↗
Work items table
Work items page — 20 per page with create, edit, retry, and delete actions
Play work items walkthrough GIF
Animated walkthrough of managing work items

Collapse to hide the animation. Open recording at full size ↗

3

Plans & PRD

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

03_plans_prd.pngOpen full size ↗
Plans and PRD progress
Plans page with status-colored cards, PRD dependency graph, and action buttons
Play plan & document chat walkthrough GIF
Animated walkthrough of plans and document chat

Collapse to hide the animation. Open recording at full size ↗

Play PRD progress walkthrough GIF
Animated walkthrough of PRD progress and dependencies

Collapse to hide the animation. Open recording at full size ↗

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.

04_pull_requests.pngOpen full size ↗
Pull requests tracker
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.

05_meetings.pngOpen full size ↗
Meetings page
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.

06_pipelines.pngOpen full size ↗
Pipelines page
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.

07_notes_kb.pngOpen full size ↗
Notes and knowledge base
Notes inbox, team notes, and knowledge base with category tabs and pagination
Play inbox & metrics walkthrough GIF
Animated walkthrough of the notes inbox and agent metrics

Collapse to hide the animation. Open recording at full size ↗

8

Scheduled Tasks

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

08_schedules.pngOpen full size ↗
Schedules page
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.

09_engine.pngOpen full size ↗
Engine page
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.

10_command_center.pngOpen full size ↗
Command Center panel
Command Center side panel with conversation history, action execution, and session indicator
Play Command Center walkthrough GIF
Animated walkthrough of the Command Center conversation panel

Collapse to hide the animation. Open recording at full size ↗

Back to the screen index ↑
04 / MAKE IT YOURS

Quick Start

just add a project. ↘
minions_setup.shTERMINAL / NODE.JS 18+
# 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
05 / UNDER THE HOOD

Architecture

the pieces fit together.
THE CENTRAL HUB

One engine.
A lot of moving parts.

Work is discovered, agents get their own worktrees, and the dashboard keeps the whole mission in view.

HOME BASE
~/.minions/
DASHBOARD
Port 7331
RUNTIMES
Claude Code or GitHub Copilot CLI

  +-----------------------------------------------------+
  |                  ~/.minions/ (central hub)          |
  |                                                     |
  |   engine.js ---- 60s 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       |
  +-----------------------------------------------------+
  
That’s the mission. Meet the rest of the experiments.

Minions — built by yemi33 — npm — Public site — MIT License — Claude Code or GitHub Copilot CLI runtime

← Experiments
5 agents. One engine. Your call.PROJECT FILE / MINIONS100%