What is Minion

An AI agent workspace designed to "mock humans"

Minion is an AI agent workspace built on the design philosophy of “mocking humans.”

What can it do?

Minion provides three main capabilities.

1. Minion provisioning and management

Easily provision VPS servers and create Claude Code agents (minions). Each minion runs in an isolated environment with its own browser, terminal, and file system.

One-click provisioning — Create minions from the HQ dashboard
Web terminal / VNC — Operate minions directly from your browser
Cloudflare Tunnel — Automatically builds secure network connections

2. Task management with skills and workflows

Combine reusable prompts (skills) into orchestrated graphs and run them automatically on cron schedules.

Skills — Version-controlled prompt templates
DAG Workflows — Node/edge graphs that run skills with parallel execution, fan-out/join, and conditional branching
Routines — Minion-specific autonomous tasks (morning prep, daily review, etc.)

Line work up as tickets and the assigned minion comes and takes it on its own, then leaves it in review once the acceptance criteria are met. Workflows are for repeatable procedures; the board is for the work that comes up as you go.

Five-column Kanban — humans and minions work the same board, backlog through done
Sprints and milestones — what comes next, and the roadmap beyond it
Custom fields — add your own rating axes and let a combined score decide the order

System architecture

flowchart TD
    HQ["<b>HQ Server</b> — ECS Fargate<br/>Next.js + WebSocket proxy<br/>Auth / Billing / Dashboard"]
    SB["<b>Supabase</b><br/>PostgreSQL + Auth + Storage + Realtime"]
    MS["<b>Minion Server</b> — Lightsail VPS<br/>Claude Code CLI + MCP servers<br/>Xvfb + noVNC + ttyd terminal<br/>Cloudflare Tunnel"]

    HQ --> SB --> MS

Next steps

Quick Start — Get your first minion up and running
Core Concepts — Understand the relationship between minions, skills, and workflows