# Proletariat

> AI agent orchestration CLI — spawn, monitor, and manage coding agents in isolated git worktrees Use when this capability is needed.

- Skill: `tomevault-io/proletariat` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/proletariat`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/proletariat/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/proletariat

---


# Proletariat (`prlt`)

Proletariat is an AI agent orchestration CLI. Use it to spawn, monitor, and manage coding agents that work on tickets in isolated git worktrees or Docker containers.

## Core Commands

### Work — Agent Lifecycle

| Command | Description |
|---------|-------------|
| `prlt work start <ticket>` | Spawn an agent on a ticket |
| `prlt work ship <ticket>` | Merge PR and close ticket |
| `prlt work propose <ticket>` | Create PR and move ticket to Review |
| `prlt work complete <ticket>` | Mark ticket as complete |
| `prlt work stop <ticket>` | Stop a running agent |
| `prlt work status <ticket>` | Check agent status for a ticket |

### Session — Monitor Agents

| Command | Description |
|---------|-------------|
| `prlt session list` | List all active agent sessions |
| `prlt session peek <agent>` | View agent output (read-only) |
| `prlt session poke <agent> "<message>"` | Send a message to a running agent |
| `prlt session attach <agent>` | Attach to an agent session interactively |
| `prlt session health` | Check health of all sessions |

### Ticket — Manage Board

| Command | Description |
|---------|-------------|
| `prlt ticket list` | List tickets on the board |
| `prlt ticket create` | Create a new ticket |
| `prlt ticket show <id>` | View full ticket details |
| `prlt ticket move <id> <status>` | Move ticket to a new status |
| `prlt ticket edit <id> [flags]` | Update ticket fields |

### PR — Pull Request Operations

| Command | Description |
|---------|-------------|
| `prlt pr checks` | Check CI status of current PR |
| `prlt pr create` | Create a PR with ticket context |
| `prlt pr status` | View PR status |

## Common Workflows

### Start work on a ticket

```bash
prlt work start PRLT-123 --skip-permissions --create-pr --yes
```

This spawns an agent in an isolated environment, checks out a new branch, and begins implementation. The `--create-pr` flag auto-creates a draft PR when the agent pushes its first commit.

### Check agent progress

```bash
prlt session peek <agent-name>
```

View the agent's recent output without interrupting it. Use `prlt session list` first to find the agent name.

### Send instructions to a running agent

```bash
prlt session poke <agent-name> "focus on the unit tests next"
```

### Ship when CI passes

```bash
prlt work ship <ticket> --when-green
```

Waits for CI checks to pass, then merges the PR and moves the ticket to Done.

### Monitor all agents

```bash
prlt session list
prlt session health
```

### Create and assign a ticket

```bash
prlt ticket create --title "Fix login bug" --priority P1
prlt ticket move TKT-456 "In Progress"
```

## Tips

- Use `prlt work start` instead of manually cloning and branching — it handles worktree isolation automatically.
- Agents run in Docker containers by default for full isolation.
- Use `prlt work propose <ticket>` instead of `gh pr create` — it keeps ticket state in sync.
- Use `prlt commit "message"` instead of `git commit` — it prefixes the ticket ID automatically.

---
> Source: [chrismcdermut/proletariat](https://github.com/chrismcdermut/proletariat) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-18 -->