Proletariat Cli
by chrismcdermutcommunityv0.3.112
31
2
prlt is an agent orchestration CLI for managing AI workers across isolated git branches and workspaces. It creates tickets, spawns agents to work on them, and can run as a built-in MCP server for AI clients.
From the registry: Agent orchestration platform - multi-agent spawning, tickets, boards, and workflows
Install & configure
Prerequisites
- requiredInstall Proletariat CLIInstall the prlt CLI. The README shows Homebrew and global npm/pnpm installs; for portability, prefer npm.
https://www.npmjs.com/package/@proletariat/cli)$ npm install -g @proletariat/cli - requiredInstall Node.js 20+Node.js 20 or newer is required; the README recommends Node.js 22 LTS.
- requiredInstall GitGit is required by prlt for repository and branch operations.
- requiredInstall Claude Code and authenticateClaude Code is listed as a requirement. Authenticate separately with Claude Code before using agent features.
$ claude login - requiredInstall SQLiteSQLite is listed as a requirement.
- requiredInstall tmuxtmux is required for session persistence.
- optionalInstall Docker (optional)Docker is optional and only needed for isolated container execution modes.
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `proletariat-cli` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Proletariat CLI** — Install the prlt CLI. The README shows Homebrew and global npm/pnpm installs; for portability, prefer npm. Run: `npm install -g @proletariat/cli` (https://www.npmjs.com/package/@proletariat/cli))
- **Install Node.js 20+** — Node.js 20 or newer is required; the README recommends Node.js 22 LTS.
- **Install Git** — Git is required by prlt for repository and branch operations.
- **Install Claude Code and authenticate** — Claude Code is listed as a requirement. Authenticate separately with Claude Code before using agent features. Run: `claude login`
- **Install SQLite** — SQLite is listed as a requirement.
- **Install tmux** — tmux is required for session persistence.
Optional prerequisites:
- Install Docker (optional) — Docker is optional and only needed for isolated container execution modes.
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@proletariat/cli","mcp-server"]
- optional environment variables:
- `GITHUB_TOKEN`: GitHub token used for GitHub operations such as pull requests. (example: `<your-github-token>`)
Note: The README also shows a direct local command form after installation: command `prlt` with args `["mcp-server"]`. For maximum portability across clients, the npx form is preferred.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README also shows a direct local command form after installation: command `prlt` with args `["mcp-server"]`. For maximum portability across clients, the npx form is preferred.
Tools (9)
ticket create
Create a ticket with structured work context such as title, category, and acceptance criteria
work spawn
Spawn an agent to work on selected tickets in an isolated workspace
work start
Start work on a ticket, with JSON mode available for machine-readable interaction
work ready
Move work to a review-ready state when a PR is ready
work complete
Mark work as completed after merge
agent themes list
List available agent naming themes
agent themes set
Set the active agent naming theme
agent themes create
Create a custom agent naming theme
agent themes add-names
Add names to a custom agent theme
Prerequisites
- • Node.js 20+
- • Node.js 22
Packages
@proletariat/cli
npmv0.3.112transport: stdio
Details
- Language
- TypeScript
- License
- Apache-2.0
- Released
- Apr 10, 2026
- Last commit
- Apr 22, 2026
- Registry name
- io.github.chrismcdermut/proletariat-cli