tty1 :: roark.daemon← indexuptime 00:14:22load 0.92● rec

                                  ╔══════════════════╗
   ┌─┐┌─┐┌─┐┬─┐┬┌─                ║   ROARK CO. INC. ║
   ├┬┘│ │├─┤├┬┘├┴┐               ╔╝╮  ━━━━━━━━━━━━━ ╔╗
   ┴└─└─┘┴ ┴┴└─┴ ┴               ║ ╲╲ AUTONOMOUS    ║║
                                 ║  ╲╲   CODING     ║║
   v0.1.x · MIT · ANSI-COMPAT    ║   ╲╲   AGENT     ║║
                                 ╚════╲╲════════════╝╝
                                       ╲╲
▌ system :: hello operator

The agent that
picks up your tickets
while you sleep.

roark is a CLI workflow runner around the Pi coding-agent SDK. Label an issue afk, run roark auto from cron, and wake up to a draft PR. No daemon. No magic. No merges.

$bun install -g roark-coding-agent⌘C
$roark auto --repo owner/repo --limit 1
▌ console.logissue #482
[00:00] gh issue list --label afk
[00:01] selected #482 "fix flaky cron in worker"
[00:01] git switch -c roark/issue-482 main
[00:02] phase=triage     verdict=proceed
[00:14] phase=plan        steps=7
[00:55] phase=implement   files=4 +112 -38
[01:42] phase=review.A    blockers=0
[01:48] phase=review.B    blockers=1
[02:31] phase=fix.1       resolved=1
[02:54] phase=final-review blockers=0
[02:55] phase=readiness   status=ready-for-pr
[02:55] verify: bun run typecheck
[02:58] ✓ exit 0
[02:59] git push -u origin roark/issue-482
[03:00] gh pr create --draft   #PR-1207
READY
afk
WIP
roark-in-progress
WIN
roark-pr-opened
FAIL
roark-failed
BLOCK
blocked
HUMAN
needs-human

▌ the workflow

do(issue) := fetch → triage → plan → implement → review → fix* → readiness → verify → pr
  1. PHASE01
    FETCH
    pull the issue, body, comments, deps
  2. PHASE02
    TRIAGE
    proceed · blocked · reject · needs-human
  3. PHASE03
    PLAN
    build a step-by-step implementation plan
  4. PHASE04
    IMPLEMENT
    edit files on a dedicated branch
  5. PHASE05
    REVIEW
    two independent review agents pass over
  6. PHASE06
    FIX
    up to N fix/review cycles
  7. PHASE07
    READINESS
    ready-for-pr · not-ready
  8. PHASE08
    VERIFY
    run typecheck, tests, anything you want
  9. PHASE09
    PUSH
    open a draft PR. only a draft. never merges.
GATE 01

readiness.md

The artifact must declare ## Status as ready-for-pr. Anything else — fail.

GATE 02

verify exit 0

--verify "bun run typecheck"via sh -c. Non-zero — fail. Roark won't push, won't lie.

ship it / while.you.sleep
▌ docs▌ github →