What is Minion

An AI agent management system designed to "mock humans"

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

What can it do?

Minion provides two 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 pipelines and run them automatically on cron schedules.

Skills — Version-controlled prompt templates
Workflows — Pipelines that execute skills in sequence
Routines — Minion-specific autonomous tasks (morning prep, daily review, etc.)

System architecture

┌──────────────────────────────────────────┐
│ HQ Server (ECS Fargate)                  │
│  Next.js + WebSocket proxy               │
│  Auth / Billing / Dashboard              │
└────────────────┬─────────────────────────┘
                 │
                 ▼
┌──────────────────────────────────────────┐
│ Supabase                                 │
│  PostgreSQL + Auth + Storage + Realtime   │
└────────────────┬─────────────────────────┘
                 │
                 ▼
┌──────────────────────────────────────────┐
│ Minion Server (Lightsail VPS)            │
│  Claude Code CLI + MCP servers           │
│  Xvfb + noVNC + ttyd terminal            │
│  Cloudflare Tunnel                       │
└──────────────────────────────────────────┘

Next steps

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