Patchmill 发布智能体驱动的软件工厂，把 issue 推进到已合并 PR

Patchmill logo

Patchmill is an agent-driven software factory for turning product work into reviewed, landed changes without hiding the engineering judgment between idea and production.

It connects an issue host, repository policy, git worktrees, and configurable agent skills so teams can triage issues, plan work, implement in isolation, review results, collect evidence, and land changes with clear handoffs.

Documentation

Read the full documentation at patchmill.dev.

Start here:

Roadmap

Patchmill's roadmap moves from safe, unattended local operation to broader work sources, a unified control plane, and cloud-operated agents running in isolated sandboxes. The phases describe product direction rather than date or version commitments.

Read the Patchmill roadmap.

Install

npm install -g patchmill

Or run one command with npx:

npx patchmill --help

Basic workflow

patchmill init
patchmill auth
patchmill doctor
patchmill triage --dry-run
patchmill triage
patchmill run-once

For independent issues, run patchmill run-once --issue N in separate terminals from the same local clone. Automatic selection remains serial. Each explicit process owns only its issue and phase workspaces.

Implementation always creates a PR. An open PR does not complete the Issue run. After the PR merges, rerun the same explicit command to finish saved checkpoints. See the operator contract for resource responsibilities, safe resume, and unsupported concurrency.

Main commands

patchmill init initializes local configuration and recommended skills.
patchmill auth configures or repairs repo-local Pi provider authentication.
patchmill doctor runs read-only readiness checks.
patchmill triage classifies open issues for automation.
patchmill run reset --issue N safely archives and resets saved Run recovery state before an immediate issue-specific Run attempt.
patchmill run-once advances one actionable issue through the configured workflow.
patchmill set-spec and patchmill set-plan publish approved workflow artifacts to an issue.
patchmill skills update updates Patchmill-managed project-local skills.

Supported hosts

Patchmill currently supports:

GitHub through the gh CLI (github-gh)
Forgejo/Gitea through the tea CLI (forgejo-tea)

Superpowers

Patchmill works especially well with the Superpowers skills pack. Patchmill provides the factory floor; Superpowers provides much of the planning, implementation, debugging, review, and workflow discipline that moves work through it.

License

Apache-2.0. See LICENSE.