Headquarters (HQ)

An HQ is your workspace for managing repositories, agents, tickets, and project state. Everything lives in a single directory with a local SQLite database.

Creating an HQ

$ prlt new my-project
? HQ name: my-project
? Location: ./my-project-hq
? Agent naming theme: billionaires
? Add repositories? Yes
? Include PMO? Yes

  Created HQ at ./my-project-hq

You can also create an HQ non-interactively for scripting or agent-driven setup:

$ prlt new --json \
    --name my-project \
    --agents bezos,musk,zuck \
    --pmo

Directory Structure

my-project-hq/

.proletariat/
  proletariat.db        # SQLite database (all state)
  config.json           # Workspace configuration
repos/
  my-app/               # Registered repository
  my-api/               # Another registered repo
agents/
  bezos/                # Agent worktree directory
  musk/                 # Another agent
pmo/
  specs/                # Specification documents
  templates/            # Action templates
  product/              # Product specs

The Database

All state is stored in a single SQLite file. This includes tickets, board columns, agent records, execution history, integration configs, and workflow settings. There are no external databases or cloud services required.

Repositories

Repos are registered with the HQ and can be cloned or symlinked. When agents spawn, they create git worktrees within the registered repos so each agent works on an isolated copy without conflicts.

PMO

The PMO (Project Management Org) provides built-in project management: tickets, kanban boards, specs, epics, and custom actions. It's optional but recommended for multi-agent workflows.

Working with Multiple HQs

You can have multiple HQs on the same machine for different projects. Each HQ is fully independent with its own database and configuration.

$ prlt new frontend-project
$ prlt new backend-project
$ prlt new mobile-project

Note

Run prlt commands from within an HQ directory, or use the PRLT_HQ_PATH environment variable to specify which HQ to use.

Registering Repositories

Add repositories to your HQ:

# Clone a remote repo
$ prlt repo add https://github.com/org/my-app

# Register a local repo
$ prlt repo add /path/to/local/repo

# List registered repos
$ prlt repo list

Getting Started

Core Concepts

Features

CLI Reference