pilot-workers

Dispatch bounded tasks to isolated LLM workers. Your main AI agent (Claude, Codex, or any planner) stays in control of requirements, planning, and verification — the worker only executes what it's told.

CLI command: pw9 (alias: pilot-workers).

What it does

  • Provider isolation: each model (GLM, Kimi, DeepSeek, or your own) gets its own credentials, XDG directories, logs, and session storage. No cross-contamination.
  • Fixed routing: provider, model, and endpoint are locked per YAML config. Tasks cannot override them.
  • Security by default: API keys never appear in CLI args, environment variables, task contracts, or logs. Output is auto-redacted.
  • Five modes: code (edit), explore (read-only), test (run tests), review (read-only audit), resume (continue a prior code session).
  • Auto-fanout review/test: pw9 review and pw9 test automatically split work by configurable axes/layers and dispatch in parallel.
  • Pluggable runners: the runner adapter layer (Runner ABC) abstracts engine-specific details. Currently ships with OpenCode.
  • Observable: two-line JSON contract (started + structured verdict) for AI planners; human-readable latest.log for tail -f.

Install

pip install pilot-workers

Quick Start

# 1. Install the worker runtime
pw9 install runner opencode

# 2. Configure a provider's API key
pw9 key glm

# 3. Check status
pw9 status

# 4. Run a task
pw9 run --provider glm --mode code --workdir /path/to/project --task-file /tmp/task.md

# 5. Auto-fanout code review (5 axes in parallel)
pw9 review --provider glm --workdir .

# 6. Auto-fanout test execution
pw9 test --provider glm --workdir .

Adding a Provider

Drop a YAML file in data/providers/ with the required fields (key, provider_id, model_id, base_url, display_name, context_tokens, output_tokens), then pw9 key <key>.

Key Commands

Command Description
pw9 key <provider> Configure API key
pw9 status [--json] Provider credentials + runner state
pw9 run --provider <key> --mode <mode> --workdir <dir> --task-file <file> Dispatch a single task
pw9 dispatch ... Like run, but stdout = two JSON lines (started + verdict)
pw9 fanout --workdir <dir> --job <provider:mode:file> ... Dispatch several jobs concurrently
pw9 review --provider <key> --workdir <dir> Auto-fanout code review by axes
pw9 test --provider <key> --workdir <dir> Auto-fanout test execution by layers
pw9 review show/add/edit/remove Manage review axes
pw9 test show/add/edit/remove Manage test layers
pw9 permissions add/remove/show <provider> ... Per-provider shell permission overrides
pw9 template <mode> Print the task template for a mode
pw9 install runner opencode Install the worker runtime
pw9 uninstall key <provider> Remove an API key

Development

python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
.venv/bin/pytest

License

MIT

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.12.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for wuchengyang from gravatar.com wuchengyang

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

yaml dev

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pilot_workers-0.8.0.tar.gz (178.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pilot_workers-0.8.0-py3-none-any.whl (121.5 kB view details)

Uploaded Python 3

File details

Details for the file pilot_workers-0.8.0.tar.gz.

File metadata

  • Download URL: pilot_workers-0.8.0.tar.gz
  • Upload date:
  • Size: 178.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pilot_workers-0.8.0.tar.gz
Algorithm Hash digest
SHA256 ca2d4b4c5b12848bba5ab8302e52f34cc8c1944aec76d86a9305d68adf7a7d4f
MD5 00422fedeafe077d4ceada604fc244d5
BLAKE2b-256 aa55944179cd8e18e37fceb411ef2b70ad13093f9fc71743fededddae6156b35

See more details on using hashes here.

Provenance

The following attestation bundles were made for pilot_workers-0.8.0.tar.gz:

Publisher: publish.yml on gWcyWoo/pilot-workers

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pilot_workers-0.8.0-py3-none-any.whl.

File metadata

  • Download URL: pilot_workers-0.8.0-py3-none-any.whl
  • Upload date:
  • Size: 121.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pilot_workers-0.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7b35ac1b03753cda17168f5a64d177c410fd53e4dea3627ec83b71327884e05b
MD5 a9c235725a00e5dbe0a0009af66d9267
BLAKE2b-256 eefa36cf154906cb897f9557592e30f0c7369f17053ddde983cccb993217df1c

See more details on using hashes here.

Provenance

The following attestation bundles were made for pilot_workers-0.8.0-py3-none-any.whl:

Publisher: publish.yml on gWcyWoo/pilot-workers

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page