PytxoPytxo
Mission control for agent fleetsLocal-firstRust coreBYOK

Coordinate headless agents. See the blast radius.

Trust your folder, pick a permission tier, and dispatch BYOK agents across DeepSeek, OpenRouter, Groq, and more — in isolated worktrees with wave plans you can preview before you run. Signal Core, Blast and Race shields, optional Reality Deck telemetry.

npm i -g pytxo
Get startedRead the docsReleases
Pytxo logo

Throughput, not terminal wallpaper

Cloud agent environments optimize for demos — sixteen panes in a browser tab, heavy RAM, proprietary credits. Pytxo coordinates headless agents locally and logs structure.

Cloud ADE pattern

Multi-pane terminal grids in remote containers

GPU-heavy browser rendering

Vendor credit models and lock-in

Telemetry = streamed terminal text

Pytxo pattern

Headless agents in local PTYs + worktrees

Rust orchestrator, SQLite WAL telemetry

BYOK — never the LLM vendor

Optional Reality Deck for structural topology

Up and running in three steps

No cloud signup. No terminal grid. Just a hypervisor on your machine.

01

Install
Build the Rust CLI, run pytxo init and pytxo doctor in your git repo.
Read guide →

02

Wire MCP
Point Cursor or your IDE at the local pytxo-mcp server for orchestration tools.
Read guide →

03

Run a wave
Schedule agents with pytxo.toml — dry-run first, then execute in isolated worktrees.
Read guide →

Three moats, one plane

Future orchestration routes through these layers — not around them. Optional Reality Deck surfaces structure; the hypervisor stays headless.

Signal Core
Compression
Tree-sitter–aware context scaffolding and checkpoint discipline so agents spend tokens on work, not noise.
Learn more →
Blast Shield
Isolation
Worktree and overlay isolation so parallel agents do not stomp the same files without explicit merge paths.
Learn more →
Race Shield
Scheduling
DAG waves and dependency-aware scheduling instead of naive global locks — throughput without chaos.
Learn more →
MCP hub
Integration
Local-first MCP routing so your IDE or Cursor session drives orchestration without replacing your editor.
Learn more →

Works with your CLI

Pytxo is the hypervisor — you bring the terminal agent. Spawn agy, Claude Code, Codex, or any command via pytxo run --cmd.

AgentRole in PytxoMode
Antigravity CLI (agy)Headless PTY childPrimary ADE
Claude CodeHeadless PTY childBYOK
OpenAI Codex CLIpytxo run --cmd "codex …"BYOK
Aider / custom scriptsAny shell commandBYOK
CursorMCP (pytxo-mcp)Local MCP

Testing ADE CLIs with Pytxo →

Control plane, not terminal wallpaper

Pytxo plugs into your existing workflow. It coordinates agents and records structure — it does not host sixteen panes in a browser tab.

IDE / CLI
Cursor, VS Code, terminal
MCP hub
Local tool routing
Orchestration
Rust scheduler + store
Execution yard
Headless PTY agents
Reality Deck
Passive telemetry (optional)
Ready to orchestrate?
Install with npm, wire MCP from Cursor or your IDE, and run your first three-agent wave in minutes.
npm i -g pytxo
Download & installFirst three-agent run

FAQ