Installation
Install the Proletariat CLI and set up the prerequisites for agent orchestration.
Prerequisites
| Requirement | Version | Purpose |
|---|---|---|
Node.js | 22+ | Runtime for the CLI |
Git | 2.20+ | Branch and worktree management |
tmux | 3.0+ | Persistent agent sessions |
Claude Code or Codex | Latest | AI coding agent runtime |
Optional
| Tool | Purpose |
|---|---|
Docker | Container isolation for agents |
GitHub CLI (gh) | PR creation and CI integration |
Install via npm
$ npm install -g @proletariat/cli
Verify the installation:
$ prlt --version @proletariat/cli/0.3.55 darwin-arm64 node-v22.22.0
Machine Setup
Run prlt init to configure your machine. This is a one-time setup that:
- Creates the global config directory at
~/.proletariat - Detects installed tools (Claude Code, Codex, Docker, tmux)
- Configures authentication for external integrations
$ prlt init
Note
prlt init is for machine setup. To create a project workspace, use prlt new.
Create a Workspace
Create your first Headquarters (HQ) workspace:
$ prlt new my-project ? Select an agent naming theme: billionaires ? Add repositories? Yes ? Repository path: ./my-app ? Include PMO (project management)? Yes Created HQ at ./my-project-hq
This creates a workspace directory with your configuration, database, and registered repositories. See Headquarters for more details.
Layer 0: No Setup Required
You can use Proletariat's core commands without creating an HQ workspace. Layer 0 commands work anywhere:
# Run an agent directly on the current repo $ prlt run "Add error handling to the API endpoints" # Check running sessions $ prlt ps # Peek at agent output $ prlt peek <session-name>
Tip
Layer 0 is great for quick one-off tasks. For managing multiple agents and tickets, create an HQ with prlt new.