proletariat
Documentation Menu

Getting Started

Core Concepts

Features

CLI Reference

Quickstart

Go from zero to a working agent in under 2 minutes. This guide walks you through creating a ticket, spawning an agent, and reviewing its work.

1. Create a workspace

If you haven't already, install and create a workspace:

$ npm install -g @proletariat/cli
$ prlt init
$ prlt new my-project

During setup, register at least one git repository and choose an agent naming theme.

2. Create a ticket

Tickets are structured work items that agents receive as context:

$ prlt ticket create \
    --title "Add rate limiting to API endpoints" \
    --description "Implement rate limiting middleware using express-rate-limit. \
    Apply to all /api routes with a limit of 100 requests per 15 minutes." \
    --priority P1 \
    --category feature

  Created TKT-001: Add rate limiting to API endpoints

Tip

Better tickets produce better results. Include acceptance criteria, relevant file paths, and any constraints the agent should follow.

3. Spawn an agent

Start an agent on the ticket. Proletariat creates a git branch, assigns a themed agent name, and launches a Claude Code session:

$ prlt work start TKT-001

  Agent "bezos" spawned on feat/TKT-001-add-rate-limiting
  Session: TKT-001-implement-bezos
  Environment: host (worktree)
  Permission mode: safe

The agent is now working autonomously. It will:

  • Read the ticket description and acceptance criteria
  • Implement the changes in its isolated worktree
  • Run tests and fix issues
  • Create a pull request when complete

4. Monitor progress

Check your board to see ticket status:

$ prlt board view

┌──────────┬──────────────┬──────────┬──────────┐
│ Backlog  │ In Progress  │ Review   │ Done     │
│          │ TKT-001      │          │          │
│          │  bezos       │          │          │
└──────────┴──────────────┴──────────┴──────────┘

Peek at what the agent is doing in real-time:

$ prlt session peek bezos

Send a message to guide the agent:

$ prlt session poke bezos "Make sure to add tests for the 429 response"

5. Scale up

Create more tickets and spawn agents on all of them at once:

$ prlt ticket create --title "Add OAuth login" --priority P1
$ prlt ticket create --title "Implement search API" --priority P2
$ prlt ticket create --title "Add dark mode" --priority P2

$ prlt work spawn --all --column Backlog

  Spawned agent "musk" on feat/TKT-002-add-oauth
  Spawned agent "zuck" on feat/TKT-003-search-api
  Spawned agent "gates" on feat/TKT-004-dark-mode
  3 agents spawned, working in parallel

6. Review the PRs

When agents complete their work, they open pull requests. Review and merge them like you would any human-authored PR.

$ prlt board view

┌──────────┬──────────────┬──────────────┬──────────┐
│ Backlog  │ In Progress  │ Review       │ Done     │
│          │              │ TKT-001 PR#5 │          │
│          │ TKT-003      │ TKT-002 PR#6 │          │
│          │  zuck        │              │          │
│          │ TKT-004      │              │          │
│          │  gates       │              │          │
└──────────┴──────────────┴──────────────┴──────────┘

Next Steps