Skip to main content

eawf — Eä Workflow

State-first, agent-driven development framework. Parallel Tasks, strict schema, Claude Code adapter.

Install

Requires Python 3.14 or newer and uv.

# one-off, leaves no command behind
uvx eawf --version

# persistent tool install
uv tool install eawf

# from a local checkout (contributors)
git clone <repo-url> eawf && cd eawf && uv sync

# Windows only: pulls the named-pipe daemon transport
uv tool install "eawf[windows]"

Full requirements, extras, and verification steps: install guide.

Quickstart

Run these from the root of any Git repository. Each command exits 0 on a clean bootstrap, and a test replays this exact block in a fresh temporary repository so the block cannot drift away from the CLI:

eawf init --quick
eawf status

eawf init --quick is the non-interactive path: it detects profiles, infers the project code from the directory name, writes the managed .gitignore block, and renders the runtime plugin tree. Drop --quick for the interactive wizard, or script it explicitly with eawf --no-input init --project-code DEMO.

Then take the repository through one full unit of work: first workflow.

Support

Platform CI runner What CI runs there
Linux ubuntu-24.04 full test suite on a real host
macOS macos-26 full test suite on a real host
Windows windows-latest named-pipe transport, packaging, and CLI smoke

Python: >=3.14, and CI pins 3.14. The floor is declared once as requires-python in pyproject.toml; the published wheel's classifiers and this table are asserted against it and against the CI matrix by tests/integration/test_packaging.py.

Workflow

research → plan a Milestone → dispatch each Batch's Tasks as Runs → cherry-pick → ship the Milestone

A Milestone is one release of work, made of Batches; a Batch groups the Tasks that land together, and each attempt at a Task is a Run. Use the slash commands /research, /plan, /dispatch, /verify, /integrate and /release to drive the lifecycle.

What gets committed

  • .ea/generations/ — the canonical project records: each generation's state.json and its append-only ledgers, with .ea/generations/selected.json naming the selected generation. The eawfd daemon is the sole writer; the eawf verbs send their writes to it over JSON-RPC. Reads need no daemon. Each generation's local/ directory holds this machine's in-flight Task status and stays gitignored.
  • AGENTS.md — agent contract, regenerated by eawf sync with the user region preserved on re-render.

The Claude Code plugin tree (.claude/ and CLAUDE.md) and any user-local files stay gitignored — they are machine-specific renders, not committed assets. Re-render anytime via eawf plugin install claude.

Docs

Start at the front door: install → quickstart → first workflow.

For the design intent behind it, read the source map for a one-line-per-package index of src/eawf/, then the architecture overview. The docs index lists everything else.

Contributing

See CONTRIBUTING.md for local development setup, harness plugin setup, and verification commands.

License

MIT — see LICENSE.

Metadata

Release files for eawf 0.7.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for eawf 0.7.1
File Size Uploaded Provenance Actions
eawf-0.7.1.tar.gz 21.2 MB With provenance Details for eawf-0.7.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for eawf 0.7.1
File Interpreter ABI Platform Actions
eawf-0.7.1-py3-none-any.whl Python 3 none any Details for eawf-0.7.1-py3-none-any.whl

Total release size: 26.2 MB

Release files / eawf-0.7.1.tar.gz

Download URL eawf-0.7.1.tar.gz
Size 21.2 MB
Tags Source
SHA-256 checksum
How to use checksums
a8f0f9b36d6bf75f10edad103162c1b1751e1892318cd44ba7ec1b48c77039a6
BLAKE2b-256 checksum
How to use checksums
2336e35f1ba9e64ee10b03bc4b43b3e77ecb36cc5f26651e428044707d732eee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

Release files / eawf-0.7.1-py3-none-any.whl

Download URL eawf-0.7.1-py3-none-any.whl
Size 5.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
2732a86491a012dcebc65aa95c33ece6e1c263b674e92bce095850683421c0b7
BLAKE2b-256 checksum
How to use checksums
745a40524a65a3787065550d1c552eb3c3070de15bec0caa3f12250a1a69b989
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

Security for eawf 0.7.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for eawf-0.7.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.7.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page