Contributing

Pytxo is MIT-licensed and its source is at Pytxo-dev/pytxo. Installers and CLI binaries ship from Pytxo-dev/pytxo-releases; to use Pytxo rather than change it, start with Install.

Development setup

git clone https://github.com/Pytxo-dev/pytxo.git
cd pytxo
cargo build --workspace

Desktop from source:

cd apps/desktop
npm ci
npm run check
cd ../..
cargo build -p pytxo-desktop

MCP binary from source:

cargo build -p pytxo-mcp --release

Smoke checks:

./tooling/scripts/smoke.sh
# Windows: ./tooling/scripts/smoke.ps1

Public docs

Edit MDX under apps/web/content/docs. Preview with pnpm --dir apps/web dev and open /docs.

Guidelines

• Route orchestration changes through the safety and coordination model where applicable
• Add tests for scheduling, worktree, and store behavior
• Update public docs when user-facing behavior changes
• Follow existing Rust formatting (cargo fmt) and CI

Pull requests

Branch from main, keep commits focused, make sure cargo test and CI pass, and link related issues or ADRs. For anything larger than a fix, open an issue first so we can agree on the approach. Report security problems privately, as described in SECURITY.md.