marge

marge

A housekeeping tool for dependency update PRs. Marge automates the approve-and-merge workflow for Renovate and Dependabot pull requests that request your review.

It searches GitHub for open bot PRs, groups them interactively, waits for CI checks to pass, approves, and merges them -- with a live terminal table showing progress.

Install

From GitHub releases

Download the latest binary from the releases page for your platform (Linux, macOS, Windows; amd64 and arm64).

From source

go install github.com/teemow/marge@latest

Or clone and build locally:

git clone https://github.com/teemow/marge.git
cd marge
make install

Setup

Marge requires a GitHub personal access token. Export it as an environment variable:

export GITHUB_TOKEN="ghp_..."

Classic token: needs the repo scope.

Fine-grained token: select the repositories you want marge to manage, then grant these permissions:

Usage

marge [query] [flags]

When run without a query, marge enters interactive mode: it fetches all open bot PRs requesting your review and lets you pick a group to process.

When run with a query (e.g. a repo name or dependency), it filters PRs directly and processes them.

Flags

Examples

Process all bot PRs interactively, grouped by repository:

marge

Process only Renovate PRs:

marge --author renovate

Filter PRs matching a query and keep watching:

marge "my-org/my-repo" --watch

Dry run to preview what would happen:

marge --dry-run

Group by dependency instead of repository:

marge --grouping dependency

Other commands

marge version         # Print the current version
marge self-update     # Update to the latest release

How it works

1. Searches GitHub for open PRs authored by app/renovate or app/dependabot that are either requesting your review or in your own repositories.
2. In interactive mode, groups results by repository (or dependency) and presents a selector.
3. For each selected PR, processes it in parallel (up to 5 concurrent):
   • Checks combined commit status and check runs; polls for up to 5 minutes if pending.
   • Approves the PR if not already approved.
   • If auto-merge is enabled, lets the merge queue handle it.
   • Otherwise merges via squash.
4. Displays a live-updating table with PR status throughout.

Development

make build          # Build the binary
make test           # Run tests
make lint           # Run golangci-lint
make help           # Show all available targets

License

MIT -- see LICENSE for details.