From a5e868231813220ac53cde9e9d8744e709b582d9 Mon Sep 17 00:00:00 2001 From: Abir Abbas Date: Mon, 1 Jun 2026 11:01:06 -0400 Subject: [PATCH 1/2] docs: lead quickstart with `af call`, keep curl as HTTP alternative The af CLI (af >= 0.1.86) ships `af call .`, which streams live progress and prints the result in a single command. Make it the primary trigger in the README so the first-run experience is friction-free, and keep the curl example right below as the raw-HTTP alternative. Co-Authored-By: Claude Opus 4.8 (1M context) --- README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/README.md b/README.md index ee666b9..dd5dd73 100644 --- a/README.md +++ b/README.md @@ -39,6 +39,22 @@ SWE-AF is a first step toward **autonomous software engineering factories**, sca ## One-Call DX +Trigger it with the `af` CLI (requires af ≥ 0.1.86) — it streams live progress and prints the result: + +```bash +af call swe-planner.build --in '{ + "goal": "Refactor and harden auth + billing flows", + "repo_url": "https://github.com/user/my-project", + "config": { + "runtime": "claude_code", + "models": { "default": "sonnet", "coder": "opus", "qa": "opus" }, + "enable_learning": true + } +}' +``` + +Prefer raw HTTP? Hit the API directly with curl: + ```bash curl -X POST http://localhost:8080/api/v1/execute/async/swe-planner.build \ -H "Content-Type: application/json" \ From 9b522f509c590382b1574227699763928bbe1d69 Mon Sep 17 00:00:00 2001 From: Abir Abbas Date: Mon, 1 Jun 2026 13:52:12 -0400 Subject: [PATCH 2/2] docs: require af >= 0.1.87 for the af call example The optional-parameter validation fix landed in af 0.1.87 (agentfield #610), so af call works for every reasoner input shape. Bump the version note. Co-Authored-By: Claude Opus 4.8 (1M context) --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index dd5dd73..ad76371 100644 --- a/README.md +++ b/README.md @@ -39,7 +39,7 @@ SWE-AF is a first step toward **autonomous software engineering factories**, sca ## One-Call DX -Trigger it with the `af` CLI (requires af ≥ 0.1.86) — it streams live progress and prints the result: +Trigger it with the `af` CLI (requires af ≥ 0.1.87) — it streams live progress and prints the result: ```bash af call swe-planner.build --in '{