How do I install the Proletariat skill?

Run npx skillmds@latest add tomevault-io/proletariat in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Proletariat safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Proletariat?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Proletariat free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Proletariat?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Proletariat by tomevault-io — Agent Skill

Name: Proletariat
Author: tomevault-io

File contents

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

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

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

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

Ship when CI passes

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

prlt session list
prlt session health

Create and assign a ticket

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 — distributed by TomeVault.

---name: proletariatdescription: AI agent orchestration CLI — spawn, monitor, and manage coding agents in isolated git worktrees Use when this capability is needed.---# 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```bashprlt 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```bashprlt 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```bashprlt session poke <agent-name> "focus on the unit tests next"```### Ship when CI passes```bashprlt work ship <ticket> --when-green```Waits for CI checks to pass, then merges the PR and moves the ticket to Done.### Monitor all agents```bashprlt session listprlt session health```### Create and assign a ticket```bashprlt ticket create --title "Fix login bug" --priority P1prlt 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).

Frequently asked questions

Proletariat