hub-pr - Manage GitHub pull requests for the current
project.
hub pr list [-s STATE] [-h HEAD] [-b
BASE] [-o SORT_KEY [-^]] [-f FORMAT] [-L LIMIT]
hub pr checkout PR-NUMBER [BRANCH]
- list
- List pull requests in the current project.
- checkout
- Check out the head of a pull request in a new branch.
- -s, --state=STATE
- Filter pull requests by STATE. Supported values are:
"open" (default), "closed", "merged", or
"all".
- -h, --head=BRANCH
- Show pull requests started from the specified head BRANCH. The
"OWNER:BRANCH" format must be used for pull requests from
forks.
- -b, --base=BRANCH
- Show pull requests based off the specified BRANCH.
- -f,
--format=FORMAT
- Pretty print the list of pull requests using format FORMAT
(default: "%sC%>(8)%i%Creset %t% l%n"). See the "PRETTY
FORMATS" section of git-log(1) for some additional details on how
placeholders are used in format. The available placeholders are:
- %I: pull request number
- %i: pull request number prefixed with "#"
- %U: the URL of this pull request
- %S: state ("open" or "closed")
- %sC: set color to red or green, depending on pull request state.
- %t: title
- %l: colored labels
- %L: raw, comma-separated labels
- %b: body
- %B: base branch
- %sB: base commit SHA
- %H: head branch
- %sH: head commit SHA
- %sm: merge commit SHA
- %au: login name of author
- %as: comma-separated list of assignees
- %rs: comma-separated list of requested reviewers
- %Mn: milestone number
- %Mt: milestone title
- %NC: number of comments
- %Nc: number of comments wrapped in parentheses, or blank string if
zero.
- %cD: created date-only (no time of day)
- %cr: created date, relative
- %ct: created date, UNIX timestamp
- %cI: created date, ISO 8601 format
- %uD: updated date-only (no time of day)
- %ur: updated date, relative
- %ut: updated date, UNIX timestamp
- %uI: updated date, ISO 8601 format
- %mD: merged date-only (no time of day)
- %mr: merged date, relative
- %mt: merged date, UNIX timestamp
- %mI: merged date, ISO 8601 format
- %n: newline
- %%: a literal %
- -o,
--sort=SORT_KEY
- Sort displayed issues by "created" (default),
"updated", "popularity", or
"long-running".
- -^ --sort-ascending
- Sort by ascending dates instead of descending.
- -L, --limit=LIMIT
- Display only the first LIMIT issues.