PR Auto-Merge Agent

Autonomous pull request merge tool. Scans GitHub repos for PRs that are approved, CI-passing, and mergeable — then merges them automatically (or reports in dry-run mode).

What It Does

• Finds all open PRs that are: not drafts + mergeable + CI passing + approved
• Merges them via --squash (default) or --admin --merge
• Supports --dry-run mode to preview what WOULD be merged without making changes
• Configurable minimum approval count
• Pure Python stdlib + gh — zero external dependencies

Prerequisites

• gh CLI authenticated (gh auth status)
• Python 3.6+
• Token must have repo scope to merge

Quick Start