aliwatters/Auto-Update PR Branches
Automatically update open PR branches when the base branch advances. Prevents stalled auto-merge from strict branch protection.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| token | GitHub token with contents:write and pull-requests:write permissions | no | ${{ github.token }} |
| filter | Which PRs to update. Options: all - Every open non-draft PR auto-merge - Only PRs with auto-merge enabled label - Only PRs with the configured label auto-merge+label - PRs with auto-merge OR the label (default) | no | all |
| label | Label name for opt-in filtering (used when filter includes 'label') | no | automerge |
| update-mode | How many PRs to update per run. Options: all - Update all eligible PRs (may cause CI stampede) next - Update only the next PR to merge (sequential, CI-efficient) test-branch - Create merge-test branches instead of modifying PR branches | no | all |
| cancel-stale-ci | Cancel in-progress/queued CI runs on branches being updated (they test stale code) | no | true |
| ci-workflow | Workflow filename for stale CI cancellation (empty = cancel all workflows on that branch) | no | "" |
| conflict-label | Label to add when a PR has merge conflicts (empty = skip labeling) | no | needs-rebase |
| conflict-comment | Post a comment on PRs with merge conflicts explaining how to resolve | no | true |
| exclude-labels | Comma-separated list of labels that exclude a PR from being updated | no | wip,do-not-merge |
| max-updates | Maximum number of PRs to update per run (0 = unlimited). Useful for rate limiting. | no | 0 |
| priority-labels | Comma-separated label-to-priority mappings. Format: label=weight (higher weight = updated first). Default priorities: critical=100, high=75, medium=50, low=25. PRs without a priority label get weight 0. Repos can override via .github/auto-update.yml config file (see README). | no | "" |
| config-file | Path to repo config file for label mappings and settings (requires checkout step) | no | .github/auto-update.yml |
| test-branch-prefix | Branch prefix for test-branch mode (default: merge-test) | no | merge-test |
| status-context | Commit status context name for test-branch mode (default: merge-test) | no | merge-test |
Outputs
| name | description |
|---|---|
| updated | Number of PRs whose branches were updated |
| conflicts | Number of PRs with merge conflicts |
| skipped | Number of PRs already up to date |
| summary | Human-readable summary of what happened |