/report

ao report

Persist a meaningful worker report for durable delivery to the active project orchestrator.

Syntax

ao report <free-form-text>
ao report --checkpoint --note <text> [output flags]
ao report --needs-input --note <text> [output flags]
ao report --stuck --note <text> [output flags]
ao report --done --note <text> [output flags]

Output flags are repeatable:

--artifact <opaque-reference>
--pr-created <github-pr-url>
--pr-reviewed <github-pr-url>

Use reports for meaningful transitions, decisions, blockers, required input, outputs, and terminal judgment. Do not narrate routine commands. Outputs do not imply completion, and `--done` does not terminate the session.

`--needs-input` requests immediate non-interrupting delivery. `--stuck` requests immediate delivery plus a rate-limited interrupt. Informational work batches for up to one hour, while the first done report opens a fixed five minute settlement window.