gh repo edit configures the squash-merge commit message

Introduced 2026-03-10 · score 0.96

HOW TO USE IT

When configuring a repository’s squash-merge behavior, run `gh repo edit` with `--squash-merge-commit-message` and one documented value. The flag is documented for use with `--enable-squash-merge`.

WHY THIS HELPS

Edit repository settings to configure the squash-merge commit message.

REQUIREMENTS AND LIMITATIONS

• Version: v2.88.0
• <repository>: Repository in `OWNER/REPO` format; omit to use the current repository.
• --enable-squash-merge: Enables merging pull requests via squashed commit; the docs describe the message setting in this context.
• --squash-merge-commit-message <string>: Sets the default squash-merge commit message behavior. Allowed values: `default`, `pr-title`, `pr-title-commits`, `pr-title-description`.
• default: Uses commit title and message for one commit, or pull request title and commit list for two or more.
• pr-title: Uses the pull request title.
• pr-title-commits: Uses the pull request title and commit list.
• pr-title-description: Uses the pull request title and description.

FIRST-PARTY EVIDENCE

• https://github.com/cli/cli/releases/tag/v2.88.0
• https://cli.github.com/manual/gh_repo_edit
• https://github.com/cli/cli/blob/v2.88.0/pkg/cmd/repo/edit/edit.go

Check the installed version and the source before using it. Entry JSON

Report a problem with this card