Pytxo

Binary: pytxo (keep aligned with site version 0.7.0).

Default behavior

pytxo          # interactive Hypervisor Shell
pytxo --help   # subcommand list

Set PYTXO_NO_TUI=1 to print help instead of launching the shell.

Command	Description
`pytxo init`	Create `.pytxo/` dirs and gitignore hint
`pytxo doctor`	Verify git, PTY, approvals persistence, billing/cloud when enabled
`pytxo run`	Schedule and execute agents in isolated copies
`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
`pytxo domains`	List registered execution domains
`pytxo project`	Multi-root modular project manifest
`pytxo fleet`	Cross-repo fleet DAG
`pytxo hitl`	Human-in-the-loop approval queue
`pytxo trust [tier]`	Trust repo folder (`orbit`, `galaxy`, ...)
`pytxo providers`	Provider registry + key configured (boolean)
`pytxo models`	List, search, or refresh model catalog

Flag	Commands	Description
`--repo`	most	Git repository root (default: cwd)
`--config`	`run`, `status`, `logs`, `stop`	Path to `pytxo.toml`
`--json`	`doctor`, `status`, `domains`	Machine-readable output

Flag	Default	Description
`--agents`	`3`	Max parallel agents per wave
`--cmd`	`echo pytxo`	Shell command in each isolated copy
`--dry-run`	off	Print JSON execution plan
`--keep-worktrees`	off	Do not remove isolated copies after run
`--execution`	from config	Override `pty`, `subprocess`, or `cloud`

Subcommand	Description
`init <id>`	Create project manifest under `~/.pytxo/projects/`
`list`	List path roots for a project
`paths --add <path>`	Add a path root
`status`	Recent runs for the project primary domain
`run`	Coordinated run across project roots

Subcommand	Description
`init <id>`	Create fleet manifest under `~/.pytxo/fleets/`
`dry-run`	Print fleet execution plan JSON
`run`	Run fleet DAG with barrier sync
`status`	List fleet runs from hypervisor catalog

pytxo fleet run --continue-on-error continues later waves after a node failure.

pytxo trust orbit
pytxo trust galaxy --repo /path/to/repo

Tiers: deep_space, orbit, galaxy, supernova. See Permission tiers.

Variable	Purpose
`PYTXO_NO_TUI`	Skip Hypervisor Shell; print help or run subcommands only
`PYTXO_REPO`	Default git root (useful for MCP)
`PYTXO_PLANNER`	Enable natural-language mission planner (`1`)
`PYTXO_ULTRA_SESSION`	Bearer token for Ultra / Link reconcile when `billing.mode = ultra`
`PYTXO_CLOUD_SESSION`	Bearer token for cloud execution when enabled
`PYTXO_DEEPSPACE_WFP`	Windows DeepSpace WFP opt-in (`1`)