Skip to content

feat(help): add detailed usage instructions and help flag to merge-pull-requests-by-title.sh #164

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
joshjohanning merged 2 commits into from
Apr 15, 2026
Merged

feat(help): add detailed usage instructions and help flag to merge-pull-requests-by-title.sh #164

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c41e02b
feat(help): add detailed usage instructions and help flag to merge-pu…
joshjohanning Mar 30, 2026
31cc9b0
fix(gh-cli): clarify --bump-patch-version does not merge alone
joshjohanning Apr 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
63 changes: 43 additions & 20 deletions gh-cli/merge-pull-requests-by-title.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,19 +68,59 @@

merge_methods=("merge" "squash" "rebase")

print_help() {
echo "Find and merge pull requests matching a title pattern across multiple repositories"
echo ""
echo "Usage:"
echo " $0 <repo_list_file> <pr_title_pattern> [merge_method] [commit_title] [flags...]"
echo " $0 --owner <owner> <pr_title_pattern> [--topic <topic>]... [merge_method] [commit_title] [flags...]"
echo ""
echo "Required (one of):"
echo " repo_list_file - File with repository URLs (one per line)"
echo " --owner <owner> - Search repositories for this user or organization"
echo ""
echo "Required:"
echo " pr_title_pattern - Title pattern to match (exact match or use * for wildcard)"
echo ""
echo "Optional positional arguments:"
echo " merge_method - Merge method: merge, squash, or rebase (default: squash)"
echo " commit_title - Custom commit title for merged PRs (PR number is auto-appended; defaults to PR title)"
echo ""
echo "Flags:"
echo " -h, --help - Show this help message and exit"
echo " --topic <topic> - Filter --owner repositories by topic (can be specified multiple times)"
echo " --dry-run - Preview what would be merged without actually merging"
echo " --bump-patch-version - Clone each matching PR branch, run npm version patch, commit, and push (does not merge; use with --enable-auto-merge to also merge)"
echo " --enable-auto-merge - Enable auto-merge on matching PRs"
echo " --no-prompt - Merge without interactive confirmation"
Comment thread
joshjohanning marked this conversation as resolved.
echo ""
echo "Flag compatibility:"
echo " --dry-run and --bump-patch-version are mutually exclusive"
echo " --dry-run and --enable-auto-merge are mutually exclusive"
echo " --topic requires --owner"
echo ""
echo "Examples:"
echo " $0 repos.txt \"chore(deps)*\" --dry-run"
echo " $0 repos.txt \"chore(deps)*\" --bump-patch-version --enable-auto-merge"
echo " $0 --owner joshjohanning --topic github-action \"chore(deps)*\" --no-prompt"
}

# Check for flags and valued options
dry_run=false
bump_patch_version=false
enable_auto_merge=false
no_prompt=false
search_owner=""
topics=()
valid_flags=("--dry-run" "--bump-patch-version" "--enable-auto-merge" "--no-prompt" "--owner" "--topic")
valid_flags=("-h" "--help" "--dry-run" "--bump-patch-version" "--enable-auto-merge" "--no-prompt" "--owner" "--topic")
args=("$@")
i=0
while [ $i -lt ${#args[@]} ]; do
arg="${args[$i]}"
if [ "$arg" = "--dry-run" ]; then
if [ "$arg" = "--help" ] || [ "$arg" = "-h" ]; then
print_help
exit 0
elif [ "$arg" = "--dry-run" ]; then
Comment thread
joshjohanning marked this conversation as resolved.
dry_run=true
elif [ "$arg" = "--bump-patch-version" ]; then
bump_patch_version=true
Expand Down Expand Up @@ -116,24 +156,7 @@ while [ $i -lt ${#args[@]} ]; do
done

if [ $# -lt 2 ]; then
echo "Usage: $0 <repo_list_file> <pr_title_pattern> [merge_method] [commit_title] [flags...]"
echo " $0 --owner <owner> <pr_title_pattern> [--topic <topic>]... [merge_method] [commit_title] [flags...]"
echo ""
echo "Required (one of):"
echo " repo_list_file - File with repository URLs (one per line)"
echo " --owner <owner> - Search repositories for this user or organization"
echo ""
echo "Required:"
echo " pr_title_pattern - Title pattern to match (use * for wildcard)"
echo ""
echo "Optional:"
echo " merge_method - merge, squash, or rebase (default: squash)"
echo " commit_title - Custom commit title for merged PRs (defaults to PR title)"
echo " --topic <topic> - Filter --owner repositories by topic (repeatable)"
echo " --dry-run - Preview what would be merged (cannot combine with --bump-patch-version or --enable-auto-merge)"
echo " --bump-patch-version - Bump npm patch version on each matching PR branch and push (cannot combine with --dry-run)"
echo " --enable-auto-merge - Enable auto-merge on matching PRs (can combine with --bump-patch-version, cannot combine with --dry-run)"
echo " --no-prompt - Merge without interactive confirmation"
print_help
exit 1
fi

Expand Down
Loading