Agents
Agents are autonomous AI coding sessions that work on tickets. Each agent gets a unique name, its own git branch, and an isolated environment.
Agent Types
Staff Agents (Persistent)
Staff agents are named, long-lived agents registered in your HQ. They persist across sessions and can be assigned multiple tickets over time.
$ prlt agent staff bezos $ prlt agent staff musk $ prlt agent list bezos staff idle musk staff idle
Ephemeral Agents (Temporary)
When you spawn work without specifying an agent, Proletariat auto-assigns a name from your theme pool. Ephemeral agents are cleaned up after their work completes.
$ prlt work start TKT-001 Agent "gates" spawned (ephemeral)
Naming Themes
Agents get memorable names from themed pools. Choose a theme during HQ creation or add custom themes:
| Theme | Example Names |
|---|---|
billionaires | bezos, musk, zuck, gates, cook, nadella, altman |
toyotas | supra, camry, tacoma, prius, corolla, tundra, rav4 |
companies | stripe, figma, vercel, linear, notion, discord |
custom | Define your own names |
# Set theme during HQ creation $ prlt new --agents-theme billionaires # Or create a custom theme $ prlt agent theme create my-theme --names "alpha,bravo,charlie,delta"
Execution Environments
Agents can run in different environments depending on your isolation requirements:
| Environment | Isolation | Use Case |
|---|---|---|
host | Git worktree only | Fast, direct filesystem access. Best for trusted codebases. |
docker | Full container | Sandboxed with Docker. Agent can't access host filesystem. |
devcontainer | VS Code devcontainer | Uses the project's .devcontainer config. |
# Run on host (default) $ prlt work start TKT-001 # Run in Docker $ prlt work start TKT-001 --environment docker # Run in devcontainer $ prlt work start TKT-001 --environment devcontainer
Permission Modes
Control how much autonomy agents have:
| Mode | Description |
|---|---|
safe | Agent asks for approval on destructive operations (default) |
danger | Full autonomy — agent can run any command without approval |
# Safe mode (default) $ prlt work start TKT-001 # Skip permission prompts $ prlt work start TKT-001 --skip-permissions
Warning
Use --skip-permissions carefully. Agents with full autonomy can run arbitrary commands on your system. Consider Docker isolation for untrusted workloads.
Display Modes
Choose how agent output is presented:
| Mode | Description |
|---|---|
terminal | Attach to the tmux session in your terminal (default) |
background | Run detached — check output later with peek |
# Interactive — see output in real-time $ prlt work start TKT-001 --display terminal # Background — fire and forget $ prlt work start TKT-001 --display background
Managing Agents
# List all agents and their status $ prlt agent list # View agent details $ prlt agent show bezos # Stop an agent's active session $ prlt session stop bezos # Clean up an agent's worktree $ prlt agent cleanup bezos