phx

A lightweight, fast, minimalistic agent harness.

Contributing

Prerequisites

• Rust (edition 2024, stable toolchain)
• just — command runner
• The wasm32-wasip2 target (installed automatically by just build)

Setup

git clone https://github.com/duckedup/phx.git
cd phx
just build

Common Commands

just build          # Build everything (plugins + binary)
just test           # Run all tests
just lint           # Format + clippy
just run            # Run phx
just run-plugins    # Run with example plugins loaded

Workflow

1. Fork the repo and create a feature branch.
2. Make your changes.
3. Run just lint and just test to verify.
4. Submit a pull request.

License

MIT