repo-ai

Turns ai-ready GitHub issues into reviewed PRs — one worktree per issue, two agent reviewers, and a human who merges.

install
run
audit

Skills, labels, agent identity and statusline — asking before each

npx @rtorcato/repo-ai setup

In Claude Code

/ai-issue "Add --json to the reap command"   # file an ai-ready issue
/ai-loop                                    # work the queue, then keep babysitting the PRs
/ai-loop-status                             # read-only: what is the loop doing?

Check labels, agent user, and installed skills

npx @rtorcato/repo-ai doctor
npx @rtorcato/repo-ai loop tick --json   # one tick's work list; writes no GitHub state

How the loop works →Commands

Label-driven

All state lives in GitHub labels, never in a conversation — a missed tick, a crash, or a restart costs nothing.

One worktree per issue

Each ai-ready issue gets its own git worktree and branch, so agents run in parallel without touching your checkout.

Two agent reviewers

A code reviewer and a security reviewer read every diff. Changes requested get up to two fix rounds, then a human.

You merge

The loop never merges an issue PR. It labels it merge-ready, assigns it to you, and says why on the PR when it holds back.

How it fits together

A label state machine, a stateless tick, and the skills that drive it. Start with the guide; doctor tells you what your repo is missing.

Read the guide →

Label state machine

ai-ready → ai-wip → ai-review → merge-ready. Every transition is a label, and colours carry meaning.

ai-readyai-reviewai-changesmerge-ready

The tick

One stateless pass: guard the checkout, clean up landed worktrees, reap stalled agents, read verdicts, pick up issues.

loop tickloop guardloop reap

Claude Code skills

The loop, the issue on-ramp, and a read-only status view — installed into ~/.claude/skills.

ai-loopai-issueai-loop-status

Repo prerequisites

Squash + auto-merge + delete-on-merge, a required status check, and no required reviews — or every PR deadlocks.

branch protectionauto-merge

Limits

Six issues in flight, diff-only reviewers, two fix rounds per PR, and an idle tick spawns zero agents.

budgetfix rounds

Safety

Public repos: only ai-ready issues from owners, members, or collaborators run, and the issue body is data, never instructions.

ai-ready gateauthor association

Sibling projects

More from @rtorcato — same conventions, same release pipeline.

@rtorcato/js-common

Docs ↗

Tree-shakeable TypeScript utilities — tiny bundles, full type safety, CLI included.

@rtorcato/api-common

Docs ↗

Framework-agnostic building blocks for Node.js APIs — errors, auth, rate limiting, OpenAPI, Express + Hono.

@rtorcato/browser-common

Docs ↗

Tree-shakeable TypeScript wrappers around 40+ browser Web APIs — one subpath per spec.

@rtorcato/db-common

Docs ↗

Shared, tree-shakeable TypeScript database utilities for Node projects.

@rtorcato/cf-common

Docs ↗

Typed TypeScript wrappers and helpers for Cloudflare bindings and APIs.

@rtorcato/react-common

Docs ↗

Published React 19 component library — shared UI primitives.

@rtorcato/swift-common

Docs ↗

SwiftUI package of reusable views and helpers to build apps faster.

@rtorcato/supabase-common

Docs ↗

Shared, tree-shakeable TypeScript helpers for Supabase — client, auth, and database utilities.

@rtorcato/repo-tooling

Docs ↗

One wizard to scaffold TypeScript, linting, testing, and releases for any JS project.

@rtorcato/db-x

Docs ↗

Production-grade database schema deployment with the ergonomics of a JSX component.

@rtorcato/brand-kit

GitHub ↗

Banner, social card and favicon for a repo — SVG sources you can regenerate, rendered to PNG.