CLI reference
Build: cargo build -p pytxo-cli
Binary: pytxo or cargo run -p pytxo-cli -- <cmd>
Commands
| Command | Description |
|---|---|
pytxo init | Create .pytxo/ dirs and gitignore hint |
pytxo doctor | Verify git, HEAD, worktrees, writable .pytxo/, PTY smoke |
pytxo run | Schedule and execute agents in worktrees |
pytxo status | List runs and agents from SQLite |
pytxo logs --agent <id> | Tail stored stdout/stderr events |
pytxo stop | Stop active run or all tracked processes |
Shared flags
| Flag | Commands | Description |
|---|---|---|
--repo | most | Git repository root (default: cwd) |
--config | run, status, logs, stop | Path to pytxo.toml |
--json | doctor, status | Machine-readable output |
pytxo run flags
| Flag | Default | Description |
|---|---|---|
--agents | 3 | Max parallel agents per wave |
--cmd | echo pytxo | Shell command in each worktree |
--dry-run | off | Print JSON execution plan |
--keep-worktrees | off | Do not remove worktrees after run |
--execution | from config | Override pty or subprocess |
run calls the same git preflight as doctor before scheduling.
Agent IDs
Format: {run_uuid}:agent-N — use with pytxo logs --agent.
See also: pytxo.toml