Skip to content

managed minions

mminions is a manager‑first orchestration system that gives OSS maintainers fast, parallel feedback on issues and PRs by spawning multiple Codex workers in tmux with isolated git worktrees.

Code Video Cerebral Valley

Core trick

Spawns parallel Codex workers in tmux, each in its own git worktree, to reproduce and triage an issue.

Tags

dev toolsagents

Description

mminions is a manager‑first orchestration system that gives OSS maintainers fast, parallel feedback on issues and PRs by spawning multiple Codex workers in tmux with isolated git worktrees. It automates repro building, hypothesis triage, and decision summaries, and exposes status/controls via CLI or API so maintainers can review results quickly and consistently. Highlights: Parallel workers for quick multi‑angle feedback Repro + minimization + triage outputs Run artifacts and summaries you can archive or share CLI/API controls for status, attach, and messaging
swap357/mminions★ 00 forksTypeScriptCreated Feb 5, 2026 · last push Feb 6, 2026

README excerpt

# mminions

Tmux session deployment for CLI agents.

## Install

```bash
uv pip install -e .
```

## Usage

```bash
# Run bug repro + triage on a GitHub issue
mminions-run --issue-url https://github.com/owner/repo/issues/123

# List active sessions
mminions ls

# Attach to a session
mminions attach mm-run-xyz-repro-w1

# Kill all sessions
mminions kill --all
```

## Config

Edit `mminions.toml`:

```toml
[manager]
repo_path = "path/to/repo"
runs_root = "runs"
workers = 2
timeout_sec = 300
model = ""
```

Team