Rookery

Label the issue.
Approve the plan.
Review the pull request.

Rookery watches your repositories for one label. It reads the issue, writes a plan you sign off on, then works the task list one task at a time and opens a draft pull request. It never merges. That part is still yours.

Free while in beta, with your own model key. Organisation keys come next.

Or the local CLI
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/sa-es-ir/rookery/releases/latest/download/rookery-cli-installer.sh | sh

Runs on your computer. No GitHub App, no account. CLI docs

sa-es-ir/rookery#3

Create the frontend portal

Operator-facing pages for the orchestrator: the agent roster, the workflow canvas, and a run view that reads its state from the issue labels. Dark theme, no build step, no framework.

opened by sa-es-ir · 4 tasks planned
  • ✓Scaffold the portal shell
  • ✓Render agents from state
  • ✓Build the workflow canvas
  • ✓Wire the run sequence
agent-plans/3/tasks.mdfeature/issue-3
The loop

Every step is a label, two of them yours

State lives on GitHub. The labels on the issue are the state machine — you can read where a run stands from the issue alone; the local database keeps only the run log. Nothing moves past a gate until you do.

A failure at any step: rookery:error and the error as a comment. approve again resumes at the first unticked task.

And on any pull request
Guarantees

Properties, not settings

These are structural. There is no configuration flag that turns them off, because each one is what keeps a long run predictable.

Approval

Your approval is read, not judged

The word is matched against a pattern, and the author must have write access on that repository. No model decides whether you meant yes, and the bot is filtered out so it can't approve itself.

How it is enforced
Authorship

One commit per approved task

Rookery ticks the checkbox and writes the commit, one for each task. Task sessions run with git push and gh denied outright, so the agent cannot publish.

How it is enforced
Limits

A daily limit, checked before every call

Each repository has a limit of model calls and of dollars for each day. Rookery checks it before each call, and a run that reaches it stops with its work committed.

How it is enforced
Cost

Task 15 costs what task 1 did

Every task gets its own session, so context never snowballs across a long issue. decisions.md is the only thing that crosses between tasks.

Isolation

One worktree per issue

Each issue gets its own branch and its own checkout, so two repositories can share an issue number and never meet.

Throughput

Repos in parallel, one job per repo

Each repository drains its own queue, so a long run on one never blocks another. Within a repo it is one job at a time, on purpose — two jobs on one issue would race on its worktree and labels.

What it won't do

The short list

neverPush to your base branch

Checked before every push. Branch protection is the backstop, not the guard.

How it is enforced
neverMerge anything

The output is a draft pull request. A human merges, every time.

How it is enforced
neverAct on an unsigned webhook

The signature is verified first, and repositories without the App installed are dropped.

neverGuess at a result

A task reports its status as a literal marker. A missing one is an error, not an assumption.

Point it at a repository

Install the GitHub App on the repos you want covered, steer each one with .rookery/workflow.json, and watch every run from one place.