roark / coding agent← index
v0.1.x · MIT · open source

An agent that reads the issue,
drafts the work, hands the merge back.

Label an issue afk. Roark claims it, plans, codes, reviews itself twice, fixes its own blockers, opens a draft PR — only when both gates pass.

▌ install
$ bun add -g roark-coding-agent
$ roark auto --repo owner/repo --limit 1
▌ premise

No daemon. No magic. No merges.

The nine phases.

  1. IFetchIssue body, comments, native + parsed dependency graph.
  2. IITriageVerdict — proceed, blocked, reject, needs-human.
  3. IIIPlanA step-by-step implementation plan for the next agent.
  4. IVImplementEdits land on roark/issue-<n>, branched from main.
  5. VReview ×2Two independent review agents pass over the diff.
  6. VIFixUp to N cycles, numbered, each one re-reviewed.
  7. VIIReadinessSelf-assessed status: ready-for-pr, or stop.
  8. VIIIVerifyYour gate command. Exit 0, or no PR.
  9. IXDraft PRgh pr create --draft. The merge is yours.
▌ two gates

Both must open.

01 — readiness

readiness.md declares ## Status: ready-for-pr. Anything else fails the gate.

02 — verify

--verify "bun run typecheck" via sh -c. Exit 0, or no push.

¶ manifesto
The work happens overnight; the judgment, in the morning. We are not in a hurry to take the merge button away from the engineer who must live with it.

Go afk.