Proletariat Cli

██████╗ ██████╗  ██████╗ ██╗     ███████╗████████╗ █████╗ ██████╗ ██╗ █████╗ ████████╗

██╔══██╗██╔══██╗██╔═══██╗██║ ██╔════╝╚══██╔══╝██╔══██╗██╔══██╗██║██╔══██╗╚══██╔══╝ ██████╔╝██████╔╝██║ ██║██║ █████╗ ██║ ███████║██████╔╝██║███████║ ██║ ██╔═══╝ ██╔══██╗██║ ██║██║ ██╔══╝ ██║ ██╔══██║██╔══██╗██║██╔══██║ ██║ ██║ ██║ ██║╚██████╔╝███████╗███████╗ ██║ ██║ ██║██║ ██║██║██║ ██║ ██║ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚══════╝ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝╚═╝ ╚═╝ ╚═╝

Seize the means of production - Ship 100x.

Agent orchestration platform for AI labor. Spin up workers for all work, on demand.

Themed agents, including billionaires - Finally, they work for us.

⚠️ Beta Software — Under active development. Commands and APIs may change between versions, and bugs are actively being squashed.

Let's get you shipping Book a call - I'm happy to help you get prlt running or chat feedback, ideas, multi-agent workflows, and the future of work/labor (and economic labor theory..)

---

TLDR

prlt is an agent orchestration platform for AI labor. Spin up workers on demand, coordinate multi-agent development from one CLI. Isolated workspaces, secure containers, persistent state.

brew install chrismcdermut/proletariat/prlt    # macOS (Homebrew)

or

npm install -g @proletariat/cli # any platform (npm)

prlt new prlt ticket create --title "Add OAuth" --category feature prlt work spawn # Interactive: select tickets, environment, action

Agent spawns in its own branch, writes code, opens PR. You review and merge.

Why prlt?

• Isolated - Each agent gets its own git branch. No conflicts.
• Secure - Docker containers, sandboxed from your host.
• Durable - Tmux sessions persist. Close window, agent keeps working.
• Trackable - One database, one CLI, all your agents.
• Ephemeral - Spawn agents on demand. They work, they PR, they're done.
• Structured - Tickets provide structured context, not freeform chat.
• Persistent - Tickets accumulate context over time. Hand off between agents.
• Agent-native - --json mode lets AI agents drive the CLI programmatically.

---

Quick Start

brew install chrismcdermut/proletariat/prlt  # Install (Homebrew, recommended)

or

npm install -g @proletariat/cli # Install (npm, all platforms)

prlt new # Create HQ, add repos, choose theme prlt ticket create --title "Add OAuth" --category feature prlt work spawn # Interactive: select tickets, environment, action

Agent creates PR → You review → Merge → Done

Workflow Diagram (click to expand)

sequenceDiagram

participant You participant prlt participant Agent participant GitHub

You->>prlt: prlt ticket create You->>prlt: prlt work spawn prlt->>prlt: Create branch prlt->>prlt: Create workspace prlt->>Agent: Spawn agent Agent->>Agent: Read ticket Agent->>Agent: Write code Agent->>GitHub: Commit Agent->>GitHub: Open PR Agent->>prlt: Update status prlt->>You: PR ready You->>GitHub: Review & approve

Spawn agents to implement, groom, or review—not just write code.

Interactive Menus

prlt work guides you through project and ticket selection:

Choose your operation—start a single agent, batch spawn, or watch a column:

Select tickets to spawn, grouped by priority:

---

Deep Dive

Installation

Homebrew (recommended)

brew install chrismcdermut/proletariat/prlt

Works on both Apple Silicon (arm64) and Intel (x86_64) Macs. No compiler needed.

Upgrade:

brew update

brew upgrade prlt

npm / pnpm (all platforms)

npm install -g @proletariat/cli

or

pnpm install -g @proletariat/cli

pnpm 10+ note: pnpm 10 blocks native addon build scripts by default. If prlt fails with a native module error after install, run pnpm approve-builds in the global store and reinstall, or use npm / brew instead.

Verify:

prlt --version

MCP Server

prlt includes a built-in MCP server with 100+ tools. Add it to your AI client:

Claude Code (~/.claude.json):

{

"mcpServers": { "prlt": { "command": "prlt", "args": ["mcp-server"] } } }

Cursor / Other clients (via npx):

{

"mcpServers": { "prlt": { "command": "npx", "args": ["-y", "@proletariat/cli", "mcp-server"] } } }

Listed on: MCP Registry | npm

Data Model

Workspace (HQ)

├── Projects │ ├── Epics → Tickets │ └── (references a Workflow) ├── Workflows → Phases → Statuses (can be shared across projects) ├── Specs (can span projects) ├── Actions (reusable templates) ├── Agents │ ├── Staff (persistent, named) │ └── Temp (ephemeral, per-ticket) └── Executions (running sessions) ├── Docker │ ├── Tmux session │ ├── Terminal or Background display │ └── Safe or YOLO permissions └── Host ├── Tmux session ├── Terminal or Background display └── Safe or YOLO permissions

Example Workflow

A workflow defines how tickets move through your process. Projects reference a workflow, and multiple projects can share the same one.

Kanban Workflow

├── Backlog # New tickets land here ├── In Progress # Agent working (prlt work spawn) ├── Review # PR ready (prlt work ready) └── Done # Merged (prlt work complete)

Scrum Workflow ├── Backlog ├── Sprint │ ├── To Do │ ├── In Progress │ └── In Review └── Done

Tickets flow through statuses as work progresses. Agents automatically move tickets when they start work, open PRs, or complete tasks.

Workspace Structure

Each agent gets a copy of all repos (repo scoping coming soon). Work happens on isolated branches.

my-project/

├── .proletariat/ │ └── workspace.db # Tickets, executions, state ├── repos/ │ ├── frontend/ # Your repos │ ├── backend/ │ └── infra/ └── agents/ ├── staff/ │ └── alice/ # Named agent with persistent workspace │ ├── frontend/ │ ├── backend/ │ └── infra/ └── temp/ ├── agent-abc123/ # Ephemeral: Working on TKT-042 (OAuth) │ ├── frontend/ # All repos on branch: feat/TKT-042-oauth │ ├── backend/ │ └── infra/ └── agent-def456/ # Ephemeral: Working on TKT-043 (API) ├── frontend/ # All repos on branch: feat/TKT-043-api ├── backend/ └── infra/

Agent Naming Themes

Themes control how agents are named. Staff agents use theme names directly (e.g., bezos, camry). Ephemeral agents add an adjective prefix (e.g., bold-bezos, keen-camry). Currently ephemeral names also include a number suffix (bold-bezos-1), but this will be removed soon.

Built-in Themes:

_billionaires_ — Finally, they work for us.

Theme Commands:

prlt agent themes list              # List available themes

prlt agent themes set billionaires # Set active theme prlt agent themes create mytheme # Create custom theme prlt agent themes add-names mytheme # Add names to custom theme

Themes are selected during prlt new.

Three Ways to Use Commands

1. Interactive (Humans)

Run without flags—get guided prompts:

$ prlt ticket create

? Title: Add password reset ? Description: Email-based password reset flow ? Priority: P1 ? Category: feature

✓ Created TKT-043

View ticket details with prlt ticket:

2. JSON Mode (AI Agents)

Add --json for machine-readable output:

$ prlt work start --json

{

"prompt": { "type": "list", "message": "Select ticket to work on:", "choices"