gg requestpull

gg requestpull [-n] [-e=0] [--title=MSG [--body=MSG]] [--draft] [-R user1[,user2]] [BRANCH]

create a GitHub pull request

Create a new GitHub pull request for the given branch (defaults to the one currently checked out). The source will be inferred from the branch’s remote push information and the destination will be inferred from upstream fetch information. This command does not push any new commits; it just creates a pull request.

Before sending the pull request, gg will open an editor with a summary of the commits it knows about. The first line will be the pull request title, and any subsequent lines will be used as the body. You can exit your editor without modifications to accept the default summary.

The first time you run requestpull, it will ask you to authorize access to GitHub. A token will be saved to $XDG_CONFIG_HOME/gg/github_token (usually ~/.config/gg/github_token). gg never sees your password, and you can revoke access at any time by visiting your GitHub settings.

Options

-body description

pull request description (requires --title)

-draft

create a pull request as draft

-e

-edit

invoke editor on pull request message (ignored if --title is specified)

-n

-dry-run

prints the pull request instead of creating it

-maintainer-edits

allow maintainers to edit this branch

-R user

-reviewer user

GitHub usernames of reviewers to add

-title string

pull request title

Aliases

• pr