Skip to main content

Testing ADE CLIs with Pytxo

Pytxo orchestrates headless terminal agents — you install the ADE CLI separately and Pytxo spawns it inside managed PTYs with git worktree isolation and Signal Core context.

Prerequisites​

npm i -g pytxo
pytxo doctor

You need:

  • Git 2.20+ with at least one commit in your test repo
  • The ADE CLI on PATH (for live runs)
  • API keys for live LLM-backed agents (BYOK)

From the Pytxo repo root:

Windows:

.\tooling\test-envs\scaffold.ps1 -Profile echo
cd $env:PYTXO_TEST_REPO
# from Pytxo repo root:
.\tooling\test-envs\recipes\smoke-echo.ps1

macOS / Linux:

./tooling/test-envs/scaffold.sh echo
cd "$PYTXO_TEST_REPO"
# from Pytxo repo root:
./tooling/test-envs/recipes/smoke-echo.sh

Profiles: echo (no API keys), context (Signal Core stub), antigravity, claude, codex.

Antigravity CLI (agy)​

Pytxo recognizes Antigravity via cli_adapter = "agy" or "antigravity" in pytxo.toml.

  1. Install Antigravity CLI and authenticate per Google's docs.

  2. Scaffold with the antigravity profile:

    .\tooling\test-envs\scaffold.ps1 -Profile antigravity
    cd $env:PYTXO_TEST_REPO
    .\tooling\test-envs\recipes\live-antigravity.ps1

  3. Dry-run the task graph:

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

  4. Smoke that agy launches in a PTY:

    pytxo run --config pytxo.toml --cmd "agy --help"

  5. Inspect telemetry:

    pytxo status
    pytxo logs --agent <run_id>:agent-0 --tail 50

Replace --cmd with your non-interactive agy invocation once the smoke passes.

Claude Code​

[[agent]]
name = "claude-builder"
paths = ["src/**"]
cli_adapter = "claude_code"
pytxo run --config pytxo.toml --cmd "claude -p \"Summarize src/a.ts\""

Requires ANTHROPIC_API_KEY (or your configured auth).

OpenAI Codex CLI​

Use the generic adapter (default). If PTY quirks appear, try subprocess:

pytxo run --config pytxo.toml --execution subprocess --cmd "codex --help"

Stub mode (no API keys)​

Use the context profile to validate Signal Core without calling an LLM:

.\tooling\test-envs\scaffold.ps1 -Profile context
cd $env:PYTXO_TEST_REPO
..\recipes\smoke-context.ps1

The stub agent prints PYTXO_CONTEXT_DIR and reads manifest.json — see the context launch contract in the repo.

Cursor (MCP, not --cmd)​

Cursor drives Pytxo through MCP, not pytxo run --cmd. See MCP from Cursor.

ADE compatibility matrix​

Agentcli_adapterTypical --cmd
Antigravity CLIagy / antigravityagy …
Claude Codeclaude_code / claudeclaude -p "…"
OpenAI Codexgenericcodex …
Aider / scriptsgenericyour command
Cursor— (MCP)pytxo-mcp tools

Next steps​