Troubleshooting
Fix common Pytxo install, trust, doctor, and MCP failures.
Start with pytxo doctor in the repo you care about. It checks git, writable data dirs, terminal support, approvals persistence, and (when enabled) cloud or billing connectivity.
| Symptom | Where to look |
|---|---|
| Doctor failures | Doctor checks |
| Trust / spawn blocked | Common failures |
| MCP path or version mismatch | Common failures |
| HITL stuck | Galaxy approvals |
Quick checks
pytxo doctor
pytxo doctor --json
pytxo trust orbitIf the Hypervisor Shell will not open in CI or pipes, set PYTXO_NO_TUI=1 and use explicit subcommands.