Available Commands
prompt
Launch agents with a prompt in isolated environments
auto
Automatically manage agent sessions and handle prompts
ls
List all active agent sessions with status
broadcast
Send messages to all active agents simultaneously
run
Execute commands across all agent sessions
checkpoint
Merge agent changes back to main worktree
kill
Terminate agent sessions and clean up resources
reset
Delete all Uzi data and start fresh
Quick Reference
| Command | Alias | Description |
|---|---|---|
prompt | p | Run prompt with specified agents |
auto | a | Auto-manage agent sessions |
ls | l | List active sessions |
broadcast | b | Send message to all agents |
run | r | Run command in all sessions |
checkpoint | c | Rebase agent changes |
kill | k | Delete agent session |
reset | - | Reset all Uzi data |
Common Workflows
Starting Agents
Monitoring Progress
Managing Changes
Global Concepts
Agent Sessions
Each agent runs in an isolated environment consisting of:- Tmux session for terminal interaction
- Git worktree for isolated file changes
- Git branch for version control
- Dev server (optional) on a dedicated port
Session Naming
Sessions follow the pattern:agent-{project}-{hash}-{agent-name}
Example: agent-uzi-a3f2b1c-thoughtful-tesla
State Management
Uzi tracks all sessions in~/.local/share/uzi/state.json with:
- Prompt text
- Branch name
- Session name
- Worktree path
- Model name
- Dev server port (if configured)