Convert issues to pull requests from the command line
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


A command-line tool to convert GitHub issues into pull requests by supplying code for them. This is based on, but without the need for pointing and clicking.


Install git-issue2pr somewhere in PATH:

sudo curl > /usr/bin/git-issue2pr
sudo chmod +x /usr/bin/git-issue2pr


First, create a personal-access token (GitHub -> Settings -> Personal access tokens (under "Developer Settings"). The token only needs public_repo - don't check any other boxes.

git config --global issue2pr.token [your token here]

Hack away in a topic branch named after the issue, e.g., issue123 for #123. When your work is complete, push to your repo on github, then

git issue2pr

That's it!

Once you've converted an issue to a PR, there's nothing more to do -- you can continue to push to the branch to update the PR as with any other PR.


The tool assumes that your repository is at a remote named origin, and that the issue is in a repository pointed to by the upstream remote. If either is not the case, simply set issue2pr.origin or issue2pr.upstream, respectively, to point to the appropriate remote or URL. For example:

git config issue2pr.upstream

or (if the my-repo remote points to your GitHub repository)

git config issue2pr.origin my-repo

Issue Number

If you don't name your topic branches after the corresponding issue, you can give issue2pr an explicit issue number to convert:

git issue2pr --issue 345

Base Branch

By default, the tool assumes that the pull request should be made against the upstream master branch. If this isn't the case, use the --branch argument:

git issue2pr --base development