Create and review GitHub pull requests with commitdog pr

Open PRs from feature branches with a diff viewer, or list, review, and merge open PRs from main — all from the terminal. GitHub only.

commitdog pr does different things depending on which branch you are on. On a feature branch it walks you through creating a pull request: you review a diff, enter a title and description, and commitdog creates the PR and opens it in your browser. On main or master it fetches all open PRs, lets you navigate them with keyboard shortcuts, view their diffs, and merge or close them without leaving the terminal.

commitdog pr works with GitHub only. Configure your GitHub token with commitdog setup before using this command.

Usage

commitdog pr

The behavior is determined automatically by your current branch.

Feature branch

Creating a PR

1. Review the diff

   commitdog shows an interactive list of files changed between your branch and the base branch, with insertion and deletion counts for each file. Navigate with j/k or the arrow keys and press d to view the inline diff for any file. Press q to proceed.

2. Enter a title and description

   commitdog pre-fills the title with your last commit subject. Press Enter to accept it or type a replacement. The description is optional.

     creating PR: feat/auth → main
   
     title › feat(auth): add refreshToken and verifyToken
     description (optional) ›
   
     [enter] confirm  [q] cancel ›
   
3. PR is created and opened

   commitdog calls the GitHub API and prints the PR number and URL:

     ✓ PR #42 created
     https://github.com/you/repo/pull/42
   
     open in browser? [Y/n] ›
   

   Press Enter or y to open the PR in your default browser.

Main branch

Reviewing PRs

When you run commitdog pr on main or master, commitdog fetches all open PRs and displays them in a scrollable list:

  open PRs — you/repo

› #42   feat/auth       → main       feat(auth): add refreshToken...   @alice
  #38   fix/login-bug   → main       fix: resolve session timeout...   @bob

Keyboard shortcuts

Key	Action
j or ↓	Move selection down
k or ↑	Move selection up
d	View the diff for the selected PR
m	Merge the selected PR
q	Quit

Merging a PR

Pressing m on a selected PR opens the merge method picker:

  merge PR #42 — feat(auth): add refreshToken and verifyToken

  1  merge commit
  2  squash merge
  3  rebase merge

  [1/2/3] pick ›

After merging, commitdog asks whether to delete the feature branch:

  ✓ merged PR #42 into main

  delete feat/auth branch? [Y/n] ›

Selecting yes deletes both the remote branch (via the GitHub API) and the local branch. commitdog then checks out the base branch and pulls the latest changes automatically:

  pulling main...
  ✓ up to date