prlt init / new
Initialize a new headquarters (HQ) — the workspace where your agents, repositories, and project management live.
Usage
$ prlt init [flags]
Flags
| Flag | Description |
|---|---|
--name, -n | HQ name (e.g., "my-project-hq") |
--path, -p | HQ directory path (defaults to ./{name}-hq) |
--agents, -a | Comma-separated list of agent names to register |
--repos, -r | Comma-separated list of repository paths to clone or link |
--pmo | Include PMO (Project Management Org) — enabled by default |
--json | Machine-readable output for agent consumption |
Examples
Interactive Setup
Run without flags for a guided setup wizard:
$ prlt init ? HQ name: my-startup-hq ? Agent names (comma-separated): bezos, musk, gates ? Repository paths: ./web, ./api, ./mobile ? Include PMO? Yes Creating headquarters at ./my-startup-hq... ✓ Created HQ directory ✓ Registered 3 agents ✓ Linked 3 repositories ✓ Initialized PMO with kanban board
One-Liner
$ prlt init --name my-hq --agents bezos,musk,gates --repos ./web,./api
Minimal Setup
# Create HQ with just a name — add agents and repos later $ prlt init --name my-hq
What Gets Created
The init command creates the following directory structure:
my-hq/ ├── repos/ # Cloned or linked repositories │ ├── web/ │ └── api/ ├── agents/ # Agent worktrees and config │ ├── bezos/ │ ├── musk/ │ └── gates/ ├── pmo/ # Project management (tickets, board, specs) │ ├── projects/ │ ├── board.md │ └── specs/ └── .prlt/ # HQ metadata and database
PMO Initialization
The PMO can also be initialized separately if you skipped it during HQ creation:
$ prlt pmo init
Tip
The PMO includes default workflow columns (Backlog, Ready, In Progress, Review, Done), priority levels (P0–P3), and common categories (feature, bug, refactor, etc.).