Skip to main content

First three-agent run

This tutorial runs three parallel agents with conflict-aware wave scheduling.

Prerequisites​

Complete Install: built CLI, pytxo init, and pytxo doctor passing.

Configure tasks​

Copy pytxo.toml.example from the repo to your project root as pytxo.toml. The example defines tasks that touch overlapping paths — Pytxo schedules them in separate waves automatically.

Dry-run (preflight)​

pytxo run --config pytxo.toml --dry-run

Inspect the JSON output: waves array and conflicts list show how scheduling will behave before any agent runs.

Run agents​

pytxo run --config pytxo.toml --cmd "echo hello-from-agent"

Each agent executes in its own git worktree. Default execution uses PTY backends for interactive shell fidelity.

Inspect telemetry​

pytxo status
pytxo logs --agent <run_uuid>:agent-0 --tail 20

Use agent IDs printed under status. Events are stored in SQLite under .pytxo/data/.

Without a config file​

For a quick smoke test:

pytxo run --agents 3 --cmd "echo pytxo"

Uses synthetic disjoint paths (src/agent-0.ts, etc.) so all three agents can run in one wave.

Benchmark script​

From the Pytxo repo root after build:

./tooling/benchmarks/three-agent-preflight.sh
# Windows:
./tooling/benchmarks/three-agent-preflight.ps1

Learn more​