Skip to content

README.md

Latest commit

 

History

History
46 lines (32 loc) · 1.78 KB

README.md

File metadata and controls

46 lines (32 loc) · 1.78 KB

Flow Examples

These are source-tree examples for acpx flow run.

They range from small primitives to one larger end-to-end example.

  • echo.flow.ts: one ACP step that returns a JSON reply
  • branch.flow.ts: ACP classification followed by a deterministic branch into either continue or checkpoint
  • pr-triage/pr-triage.flow.ts: a larger single-PR workflow example with a colocated written spec in pr-triage/README.md
  • replay-viewer/: a browser app that visualizes saved flow run bundles with React Flow, a recent-runs picker, ACP session inspection, and a dedicated viewer spec in docs/2026-03-27-flow-replay-viewer.md
  • shell.flow.ts: one native runtime-owned shell action that returns structured JSON
  • workdir.flow.ts: native workspace prep followed by an ACP step that runs inside that isolated cwd
  • two-turn.flow.ts: two ACP prompts in the same implicit main session

Run them from the repo root:

acpx flow run examples/flows/echo.flow.ts \
  --input-json '{"request":"Summarize this repository in one sentence."}'

acpx flow run examples/flows/branch.flow.ts \
  --input-json '{"task":"FIX: add a regression test for the reconnect bug"}'

acpx flow run examples/flows/pr-triage/pr-triage.flow.ts \
  --input-json '{"repo":"openclaw/acpx","prNumber":150}'

acpx flow run examples/flows/shell.flow.ts \
  --input-json '{"text":"hello from shell"}'

acpx flow run examples/flows/workdir.flow.ts

acpx flow run examples/flows/two-turn.flow.ts \
  --input-json '{"topic":"How should we validate a new ACP adapter?"}'

Run the replay viewer from the repo root:

pnpm run viewer:preview

These examples are examples only. They do not define acpx core product behavior.

The PR-triage example can comment on or close real GitHub PRs if you run it against a live repository.