ghprmerge

ghprmerge

A command-line tool to automatically evaluate, merge, and optionally rebase GitHub pull requests sharing the same source branch across an organization.

Use case: merging automated dependency update pull requests (e.g., Dependabot) without requiring clicking through each repository individually.

Quick Start

# Set your GitHub token
export GITHUB_TOKEN=ghp_xxxxxxxxxxxx

# Check version
ghprmerge --version

# Analyze what would be merged (default mode)
ghprmerge --org myorg --source-branch dependabot/

# Rebase out-of-date branches
ghprmerge --org myorg --source-branch dependabot/ --rebase

# Merge ready PRs (that are already up-to-date)
ghprmerge --org myorg --source-branch dependabot/ --merge

# PRs with no checks configured are allowed; pending checks still block merging

# Merge PRs even if behind (skip rebase requirement)
ghprmerge --org myorg --source-branch dependabot/ --merge --skip-rebase

# Use --confirm to review pending actions before taking action
ghprmerge --org myorg --source-branch dependabot/ --rebase --confirm

# Stream all repo results as they are scanned
ghprmerge --org myorg --source-branch dependabot/ --verbose

# Disable colored output
ghprmerge --org myorg --source-branch dependabot/ --no-color

# Report mode: group open PRs by source branch
ghprmerge --org myorg --report

# Report with prefix filter and JSON output
ghprmerge --org myorg --report --source-branch-prefix dependabot/ --json

# Report with minimum group size
ghprmerge --org myorg --report --min-group-size 3

Documentation

• Purpose & Philosophy - Design goals and safety model
• Usage Guide - Complete command-line reference
• Examples - Practical workflows
• Installation - Installation instructions

License

MIT License - see LICENSE for details.