Autorepo

GitHub issue automation for repo-local agent worktrees, checks, and pull requests.

TL;DR: Autorepo turns GitHub Issues into managed implementation runs: isolated worktrees, branch discipline, verification, and pull requests with evidence.

TL;DR: Autorepo turns GitHub Issues into managed implementation runs: isolated worktrees, branch discipline, verification, and pull requests with evidence.


What It Does

Autorepo is a repository automation layer for teams that want issue-driven agent work without losing control of the codebase. It treats GitHub Issues as the execution queue, creates repo-local worktrees for implementation, keeps branches scoped to the issue, and pushes completed work through the same review path as human-authored changes.

The point is repeatability. Agents are useful when they can take a clearly bounded task, make the change in isolation, run the right checks, and leave behind enough evidence for a maintainer to review quickly. Autorepo handles the operational glue around that loop so the repo stays organized while more work happens in parallel.

Technical Notes

The core workflow is intentionally simple: claim an issue, create a worktree, run the assigned implementation pass, verify the touched workspace, and publish a pull request. Each run keeps the branch, working directory, logs, and PR metadata tied back to the originating issue.

Key decisions:

  • Issue-first execution - GitHub Issues remain the source of truth for task scope, prioritization, and status
  • Worktree isolation - each run gets its own checkout so concurrent agent work does not collide with coordination state or another run’s changes
  • Evidence-based handoff - verification commands, diffs, and implementation notes are attached to the PR instead of living only in terminal history
  • Design Review built in - frontend changes can be checked against a repo-local DESIGN.md, turning the product’s visual standard into a CI gate instead of relying on generic taste. I wrote more about that workflow in How I Code: Summer 2026 Edition.
  • Repo-native review - Autorepo does not replace pull requests, branch protection, or CI; it feeds them cleaner inputs

Outcomes

Autorepo makes agent implementation work less ad hoc. The durable improvement is not just faster code changes, but cleaner coordination: fewer mystery branches, fewer half-finished local edits, and a clearer path from issue to reviewed PR.