NAME

       hub-pull-request - Create a GitHub pull request.

SYNOPSIS

       hub pull-request [-focp] [-b BASE] [-h HEAD] [-r REVIEWERS ] [-a ASSIGNEES] [-M MILESTONE]
       [-l LABELS]
       hub pull-request -m MESSAGE [--edit]
       hub pull-request -F FILE [--edit]
       hub pull-request -i ISSUE

OPTIONS

       -f, --force
              Skip the check for unpushed commits.

       -m, --message=MESSAGE
              The text up to the first blank line in MESSAGE  is  treated  as  the  pull  request
              title, and the rest is used as pull request description in Markdown format.

              If  multiple  MESSAGE  options are given, their values are concatenated as separate
              paragraphs.

       --no-edit
              Use the message from the first commit on the  branch  as  pull  request  title  and
              description without opening a text editor.

       -F, --file=FILE
              Read the pull request title and description from FILE.

       -e, --edit
              Further edit the contents of FILE in a text editor before submitting.

       -i, --issue=ISSUE
              Convert an issue to a pull request. ISSUE may be an issue number or a URL.

              You  can  only convert issues that youve opened or that which you have admin rights
              over. In most workflows it isnt necessary to convert issues to pull  requests;  you
              can simply reference the original issue in the body of the new pull request.

       -o, --browse
              Open the new pull request in a web browser.

       -c, --copy
              Put the URL of the new pull request to clipboard instead of printing it.

       -p, --push
              Push the current branch to HEAD before creating the pull request.

       -b, --base=BASE
              The  base  branch in the "[OWNER:]BRANCH" format. Defaults to the default branch of
              the upstream repository (usually "master").

              See the "CONVENTIONS" section of hub(1) for more information on how hub selects the
              defaults in case of multiple git remotes.

       -h, --head=HEAD
              The  head  branch in "[OWNER:]BRANCH" format. Defaults to the currently checked out
              branch.

       -r, --reviewer=USERS
              A comma-separated list of GitHub handles to request a review from.

       -a, --assign=USERS
              A comma-separated list of GitHub handles to assign to this pull request.

       -M, --milestone=NAME
              The milestone name to add to this pull request. Passing  the  milestone  number  is
              deprecated.

       -l, --labels=LABELS
              Add  a  comma-separated list of labels to this pull request. Labels will be created
              if they don`t already exist.

EXAMPLES

       $ hub pull-request
       [ opens a text editor for writing title and message ]
       [ creates a pull request for the current branch ]

       $ hub pull-request --base OWNER:master --head MYUSER:my-branch
       [ creates a pull request with explicit base and head branches ]

       $ hub pull-request --browse -m "My title"
       [ creates a pull request with the given title and opens it in a browser ]

       $ hub pull-request -F - --edit < path/to/message-template.md
       [ further edit the title and message received on standard input ]

CONFIGURATION

       HUB_RETRY_TIMEOUT=SECONDS The maximum time to keep  retrying  after  HTTP  422  on  --push
       (default: 9).

SEE ALSO

       hub(1), hub-merge(1), hub-checkout(1)