proletariat
Documentation Menu

Getting Started

Core Concepts

Features

CLI Reference

Documentation

Proletariat is an open-source agent orchestration platform. Spawn, manage, and coordinate AI coding agents to ship software at 100x speed.

What is Proletariat?

Proletariat (prlt) is a CLI tool that lets you run dozens of AI coding agents in parallel, each working on separate tickets in isolated git branches and worktrees. It combines project management (tickets, kanban boards, specs) with agent orchestration (spawning, monitoring, session management) in a single local-first tool.

Instead of chatting with one AI assistant at a time, Proletariat lets you describe work as structured tickets and spawn autonomous agents to implement them. Each agent gets its own environment, its own branch, and creates a PR when done.

Key Features

  • Parallel execution — Run 50+ agents simultaneously with zero conflicts
  • Structured work — Tickets with descriptions, acceptance criteria, and subtasks
  • Kanban workflow — Built-in board with customizable columns
  • Git isolation — Each agent gets its own branch and worktree
  • Docker sandboxing — Optional container isolation for each agent
  • Persistent sessions — Tmux-backed sessions survive disconnects
  • Integrations — Linear, Jira, Asana, Shortcut support
  • Local-first — SQLite database, no cloud dependency
  • JSON mode — Machine-readable output for agent-to-agent automation

Quick Start

$ npm install -g @proletariat/cli
$ prlt init
$ prlt new my-project
$ prlt ticket create --title "Add user authentication"
$ prlt work start TKT-001

Tip

If you have Claude Code or Codex installed, prlt init will detect it and offer an AI-assisted setup experience.

How It Works

The typical Proletariat workflow:

  1. Create tickets describing the work you want done, with acceptance criteria that agents can verify against.
  2. Spawn agents on tickets. Each agent gets a unique name (from themed name pools like “billionaires” or “toyotas”), its own git branch, and a tmux session.
  3. Agents work autonomously — they read the ticket, implement the changes, run tests, and open a pull request.
  4. Monitor progress with the kanban board, session peek, or work watch commands. Poke agents with messages if they need guidance.
  5. Review and merge the PRs your agents create, just like you would with human contributors.

Architecture

Proletariat organizes work around a Headquarters (HQ) — a workspace directory that contains your configuration, database, repos, and agent state. The HQ uses a local SQLite database for all state management, with no cloud dependencies.

HQ structure
my-project-hq/
  .proletariat/       # Config and database
    proletariat.db    # SQLite database
    config.json       # Workspace configuration
  repos/              # Registered repositories
    my-app/           # Git repo (clone or symlink)
  agents/             # Agent worktrees and state
  pmo/                # Project management artifacts
    specs/            # Specification documents
    templates/        # Action templates

Next Steps