Skip to main content

Install

Pytxo ships as a Rust workspace. Build the CLI from source today; packaged installers are on the Download page roadmap.

Prerequisites​

  • Rust toolchain (see rust-toolchain.toml in the repo)
  • Git 2.20+ with worktree support
  • A git repository with at least one commit (your project root)

Build the CLI​

git clone https://github.com/Pytxo-dev/pytxo.git
cd pytxo
cargo build -p pytxo-cli --release

The binary is at target/release/pytxo (or pytxo.exe on Windows). Add it to your PATH, or use cargo run -p pytxo-cli -- during development.

Initialize a project​

From your git repo root:

pytxo init

This creates .pytxo/worktrees, .pytxo/data, and adds .pytxo/ to .gitignore.

Verify your environment​

pytxo doctor

doctor checks git, HEAD, worktree support, writable .pytxo/, and a PTY smoke test. Fix any failures before running agents.

Next steps​