prlt agent
Manage your agent pool — register staff agents, configure naming themes, check status, and clean up after work is done.
Subcommands
| Command | Description |
|---|---|
agent list | List all agents and their current status |
agent staff | Manage staff (persistent) agents |
agent status | Show detailed agent status |
agent visit | Open an agent's working directory |
agent remove | Remove an agent from the HQ |
agent cleanup | Clean up agent worktrees and temporary files |
agent shell | Open a shell in an agent's environment |
agent restart | Restart an agent |
agent rebuild | Rebuild an agent's environment |
agent discover | Discover agents on disk that aren't registered |
agent themes | Manage agent naming themes |
agent login | Login for an agent |
agent auth | Set up agent authentication |
agent list
$ prlt agent list bezos staff idle musk staff working TKT-003 gates ephemeral working TKT-007 # Filter by type $ prlt agent list --type staff $ prlt agent list --type temp
agent staff
Staff agents are persistent, named agents that stay registered in your HQ across sessions.
# Add a staff agent $ prlt agent staff add bezos # List staff agents $ prlt agent staff list # Remove a staff agent $ prlt agent staff remove bezos
agent cleanup
# Clean up a specific agent $ prlt agent cleanup bezos # Clean up all temporary agents $ prlt agent cleanup --temp
Note
Cleanup removes git worktrees, temporary branches, and session artifacts. Staff agents remain registered but their workspace is reset.
agent themes
Naming themes provide memorable names for auto-assigned agents.
# Create a custom theme $ prlt agent themes create my-theme --names "alpha,bravo,charlie,delta" # List available themes $ prlt agent themes list # Set the active theme $ prlt agent themes set my-theme
| Built-in Theme | Example Names |
|---|---|
billionaires | bezos, musk, zuck, gates, cook, nadella |
toyotas | supra, camry, tacoma, prius, corolla, tundra |
companies | stripe, figma, vercel, linear, notion, discord |