Autorun

roark auto --repo owner/repo --limit 1

#Flow

1. List open GitHub issues.
2. Select issues with the ready label and no skip labels.
3. Claim one issue by assigning the actor, applying the in-progress label, and posting a claim comment.
4. Prepare the managed workspace and issue branch.
5. Fetch issue context and dependency metadata.
6. Run triage, planning, implementation, review, fix passes, and readiness.
7. Apply the readiness gate.
8. Run the verification gate.
9. If verification fails and maxFixPasses has budget, repair through fix pass + final review + readiness, then rerun verification.
10. On success, commit code changes, push the branch, and open a PR.
11. On exhausted-budget or non-repairable failure, leave work uncommitted and post recovery information.

#Recommended posture

Keep --limit 1 while building trust. Roark is intentionally one-shot; use an external scheduler if you want periodic execution.

#Selection labels

The default ready label is afk. The default skip set includes lifecycle/status labels such as roark-in-progress, roark-failed, and roark-pr-opened.

See Label semantics for the full label reference.

#Safety boundaries

Autorun never merges PRs or closes issues. A human reviewer remains responsible for reviewing PRs and merging them.

#Useful commands

Preview selection:

roark auto --repo owner/repo --limit 1 --dry-run

Target one issue through the autorun path:

roark auto 123 --repo owner/repo

Inspect status after a background run:

roark status 123 --repo owner/repo

#Next steps

• Use Quickstart before the first autorun.
• Use Scheduling and Operations runbook before repeated runs.
• Use Troubleshooting when selection is surprising.