github.com/echohead/hub@v2.2.1+incompatible/man/hub.1.html (about)

     1  <!DOCTYPE html>
     2  <html>
     3  <head>
     4    <meta http-equiv='content-type' value='text/html;charset=utf8'>
     5    <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
     6    <title>hub(1) - git + hub = github</title>
     7    <style type='text/css' media='all'>
     8    /* style: man */
     9    body#manpage {margin:0}
    10    .mp {max-width:100ex;padding:0 9ex 1ex 4ex}
    11    .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
    12    .mp h2 {margin:10px 0 0 0}
    13    .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
    14    .mp h3 {margin:0 0 0 4ex}
    15    .mp dt {margin:0;clear:left}
    16    .mp dt.flush {float:left;width:8ex}
    17    .mp dd {margin:0 0 0 9ex}
    18    .mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
    19    .mp pre {margin-bottom:20px}
    20    .mp pre+h2,.mp pre+h3 {margin-top:22px}
    21    .mp h2+pre,.mp h3+pre {margin-top:5px}
    22    .mp img {display:block;margin:auto}
    23    .mp h1.man-title {display:none}
    24    .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
    25    .mp h2 {font-size:16px;line-height:1.25}
    26    .mp h1 {font-size:20px;line-height:2}
    27    .mp {text-align:justify;background:#fff}
    28    .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
    29    .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
    30    .mp u {text-decoration:underline}
    31    .mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
    32    .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
    33    .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
    34    .mp b.man-ref {font-weight:normal;color:#434241}
    35    .mp pre {padding:0 4ex}
    36    .mp pre code {font-weight:normal;color:#434241}
    37    .mp h2+pre,h3+pre {padding-left:0}
    38    ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
    39    ol.man-decor {width:100%}
    40    ol.man-decor li.tl {text-align:left}
    41    ol.man-decor li.tc {text-align:center;letter-spacing:4px}
    42    ol.man-decor li.tr {text-align:right;float:right}
    43    </style>
    44  </head>
    45  <!--
    46    The following styles are deprecated and will be removed at some point:
    47    div#man, div#man ol.man, div#man ol.head, div#man ol.man.
    48  
    49    The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
    50    .man-navigation should be used instead.
    51  -->
    52  <body id='manpage'>
    53    <div class='mp' id='man'>
    54  
    55    <div class='man-navigation' style='display:none'>
    56      <a href="#NAME">NAME</a>
    57      <a href="#SYNOPSIS">SYNOPSIS</a>
    58      <a href="#DESCRIPTION">DESCRIPTION</a>
    59      <a href="#CONFIGURATION">CONFIGURATION</a>
    60      <a href="#EXAMPLES">EXAMPLES</a>
    61      <a href="#BUGS">BUGS</a>
    62      <a href="#AUTHORS">AUTHORS</a>
    63      <a href="#SEE-ALSO">SEE ALSO</a>
    64    </div>
    65  
    66    <ol class='man-decor man-head man head'>
    67      <li class='tl'>hub(1)</li>
    68      <li class='tc'>Hub Manual</li>
    69      <li class='tr'>hub(1)</li>
    70    </ol>
    71  
    72    <h2 id="NAME">NAME</h2>
    73  <p class="man-name">
    74    <code>hub</code> - <span class="man-whatis">git + hub = github</span>
    75  </p>
    76  
    77  <h2 id="SYNOPSIS">SYNOPSIS</h2>
    78  
    79  <p><code>hub</code> [<code>--noop</code>] <var>COMMAND</var> <var>OPTIONS</var><br />
    80  <code>hub alias</code> [<code>-s</code>] [<var>SHELL</var>]</p>
    81  
    82  <h3 id="Expanded-git-commands-">Expanded git commands:</h3>
    83  
    84  <p><code>git init -g</code> <var>OPTIONS</var><br />
    85  <code>git clone</code> [<code>-p</code>] <var>OPTIONS</var> [<var>USER</var>/]<var>REPOSITORY</var> <var>DIRECTORY</var><br />
    86  <code>git remote add</code> [<code>-p</code>] <var>OPTIONS</var> <var>USER</var>[/<var>REPOSITORY</var>]<br />
    87  <code>git remote set-url</code> [<code>-p</code>] <var>OPTIONS</var> <var>REMOTE-NAME</var> <var>USER</var>[/<var>REPOSITORY</var>]<br />
    88  <code>git fetch</code> <var>USER-1</var>,[<var>USER-2</var>,...]<br />
    89  <code>git checkout</code> <var>PULLREQ-URL</var> [<var>BRANCH</var>]<br />
    90  <code>git merge</code> <var>PULLREQ-URL</var><br />
    91  <code>git cherry-pick</code> <var>GITHUB-REF</var><br />
    92  <code>git am</code> <var>GITHUB-URL</var><br />
    93  <code>git apply</code> <var>GITHUB-URL</var><br />
    94  <code>git push</code> <var>REMOTE-1</var>,<var>REMOTE-2</var>,...,<var>REMOTE-N</var> [<var>REF</var>]<br />
    95  <code>git submodule add</code> [<code>-p</code>] <var>OPTIONS</var> [<var>USER</var>/]<var>REPOSITORY</var> <var>DIRECTORY</var></p>
    96  
    97  <h3 id="Custom-git-commands-">Custom git commands:</h3>
    98  
    99  <p><code>git create</code> [<var>NAME</var>] [<code>-p</code>] [<code>-d</code> <var>DESCRIPTION</var>] [<code>-h</code> <var>HOMEPAGE</var>]<br />
   100  <code>git browse</code> [<code>-u</code>] [[<var>USER</var><code>/</code>]<var>REPOSITORY</var>] [SUBPAGE]<br />
   101  <code>git compare</code> [<code>-u</code>] [<var>USER</var>] [[<var>START</var>...]<var>END</var>]<br />
   102  <code>git fork</code> [<code>--no-remote</code>]<br />
   103  <code>git pull-request</code> [<code>-o</code>|<code>--browse</code>] [<code>-f</code>] [<code>-m</code> <var>MESSAGE</var>|<code>-F</code> <var>FILE</var>|<code>-i</code> <var>ISSUE</var>|<var>ISSUE-URL</var>] [<code>-b</code> <var>BASE</var>] [<code>-h</code> <var>HEAD</var>]<br />
   104  <code>git ci-status</code> [<code>-v</code>] [<var>COMMIT</var>]</p>
   105  
   106  <h2 id="DESCRIPTION">DESCRIPTION</h2>
   107  
   108  <p>hub enhances various git commands to ease most common workflows with GitHub.</p>
   109  
   110  <dl>
   111  <dt><code>hub --noop</code> <var>COMMAND</var></dt><dd><p>Shows which command(s) would be run as a result of the current command.
   112  Doesn't perform anything.</p></dd>
   113  <dt><code>hub alias</code> [<code>-s</code>] [<var>SHELL</var>]</dt><dd><p>Shows shell instructions for wrapping git. If given, <var>SHELL</var> specifies the
   114  type of shell; otherwise defaults to the value of SHELL environment
   115  variable.  With <code>-s</code>, outputs shell script suitable for <code>eval</code>.</p></dd>
   116  <dt><code>git init</code> <code>-g</code> <var>OPTIONS</var></dt><dd><p>Create a git repository as with <span class="man-ref">git-init<span class="s">(1)</span></span> and add remote <code>origin</code> at
   117  "git@github.com:<var>USER</var>/<var>REPOSITORY</var>.git"; <var>USER</var> is your GitHub username and
   118  <var>REPOSITORY</var> is the current working directory's basename.</p></dd>
   119  <dt><code>git clone</code> [<code>-p</code>] <var>OPTIONS</var> [<var>USER</var><code>/</code>]<var>REPOSITORY</var> <var>DIRECTORY</var></dt><dd><p>Clone repository "git://github.com/<var>USER</var>/<var>REPOSITORY</var>.git" into
   120  <var>DIRECTORY</var> as with <span class="man-ref">git-clone<span class="s">(1)</span></span>. When <var>USER</var>/ is omitted, assumes
   121  your GitHub login.</p>
   122  
   123  <p>If the repository is private or the current user has push access to the
   124  repository, hub will use the ssh protocol for cloning. Use <code>-p</code> to select
   125  the ssh protocol unconditionally. HTTPS protocol can be used instead by
   126  setting "hub.protocol" (see <var>CONFIGURATION</var>).</p></dd>
   127  <dt><code>git remote add</code> [<code>-p</code>] <var>OPTIONS</var> <var>USER</var>[<code>/</code><var>REPOSITORY</var>]</dt><dd><p>Add remote "git://github.com/<var>USER</var>/<var>REPOSITORY</var>.git" as with
   128  <span class="man-ref">git-remote<span class="s">(1)</span></span>. When /<var>REPOSITORY</var> is omitted, the basename of the
   129  current working directory is used. With <code>-p</code>, use private remote
   130  "git@github.com:<var>USER</var>/<var>REPOSITORY</var>.git". If <var>USER</var> is "origin"
   131  then uses your GitHub login.</p></dd>
   132  <dt><code>git remote set-url</code> [<code>-p</code>] <var>OPTIONS</var> <var>REMOTE-NAME</var> <var>USER</var>[/<var>REPOSITORY</var>]</dt><dd><p>Sets the url of remote <var>REMOTE-NAME</var> using the same rules as
   133  <code>git remote add</code>.</p></dd>
   134  <dt><code>git fetch</code> <var>USER-1</var>,[<var>USER-2</var>,...]</dt><dd><p>Adds missing remote(s) with <code>git remote add</code> prior to fetching. New
   135  remotes are only added if they correspond to valid forks on GitHub.</p></dd>
   136  <dt><code>git checkout</code> <var>PULLREQ-URL</var> [<var>BRANCH</var>]</dt><dd><p>Checks out the head of the pull request as a local branch, to allow for
   137  reviewing, rebasing and otherwise cleaning up the commits in the pull
   138  request before merging. The name of the local branch can explicitly be
   139  set with <var>BRANCH</var>.</p></dd>
   140  <dt><code>git merge</code> <var>PULLREQ-URL</var></dt><dd><p>Merge the pull request with a commit message that includes the pull request
   141  ID and title, similar to the GitHub Merge Button.</p></dd>
   142  <dt><code>git cherry-pick</code> <var>GITHUB-REF</var></dt><dd><p>Cherry-pick a commit from a fork using either full URL to the commit
   143  or GitHub-flavored Markdown notation, which is <code>user@sha</code>. If the remote
   144  doesn't yet exist, it will be added. A <code>git fetch &lt;user></code> is issued
   145  prior to the cherry-pick attempt.</p></dd>
   146  <dt><code>git [am|apply]</code> <var>GITHUB-URL</var></dt><dd><p>Downloads the patch file for the pull request or commit at the URL and
   147  applies that patch from disk with <code>git am</code> or <code>git apply</code>. Similar to
   148  <code>cherry-pick</code>, but doesn't add new remotes. <code>git am</code> creates commits while
   149  preserving authorship info while <code>apply</code> only applies the patch to the
   150  working copy.</p></dd>
   151  <dt><code>git push</code> <var>REMOTE-1</var>,<var>REMOTE-2</var>,...,<var>REMOTE-N</var> [<var>REF</var>]</dt><dd><p>Push <var>REF</var> to each of <var>REMOTE-1</var> through <var>REMOTE-N</var> by executing
   152  multiple <code>git push</code> commands.</p></dd>
   153  <dt><code>git submodule add</code> [<code>-p</code>] <var>OPTIONS</var> [<var>USER</var>/]<var>REPOSITORY</var> <var>DIRECTORY</var></dt><dd><p>Submodule repository "git://github.com/<var>USER</var>/<var>REPOSITORY</var>.git" into
   154  <var>DIRECTORY</var> as with <span class="man-ref">git-submodule<span class="s">(1)</span></span>. When <var>USER</var>/ is omitted, assumes
   155  your GitHub login. With <code>-p</code>, use private remote
   156  "git@github.com:<var>USER</var>/<var>REPOSITORY</var>.git".</p></dd>
   157  <dt><code>git help</code></dt><dd><p>Display enhanced <span class="man-ref">git-help<span class="s">(1)</span></span>.</p></dd>
   158  </dl>
   159  
   160  
   161  <p>hub also adds some custom commands that are otherwise not present in git:</p>
   162  
   163  <dl>
   164  <dt><code>git create</code> [<var>NAME</var>] [<code>-p</code>] [<code>-d</code> <var>DESCRIPTION</var>] [<code>-h</code> <var>HOMEPAGE</var>]</dt><dd><p>Create a new public GitHub repository from the current git
   165  repository and add remote <code>origin</code> at
   166  "git@github.com:<var>USER</var>/<var>REPOSITORY</var>.git"; <var>USER</var> is your GitHub
   167  username and <var>REPOSITORY</var> is the current working directory name.
   168  To explicitly name the new repository, pass in <var>NAME</var>, optionally in
   169  <var>ORGANIZATION</var>/<var>NAME</var> form to create under an organization you're a
   170  member of. With <code>-p</code>, create a private repository, and with <code>-d</code> and <code>-h</code>
   171  set the repository's description and homepage URL, respectively.</p></dd>
   172  <dt><code>git browse</code> [<code>-u</code>] [[<var>USER</var><code>/</code>]<var>REPOSITORY</var>] [SUBPAGE]</dt><dd><p>Open repository's GitHub page in the system's default web browser using
   173  <code>open(1)</code> or the <code>BROWSER</code> env variable. If the repository isn't
   174  specified, <code>browse</code> opens the page of the repository found in the current
   175  directory.
   176  If SUBPAGE is specified, the browser will open on the specified
   177  subpage: one of "wiki", "commits", "issues" or other (the default is
   178  "tree"). A specific commit in the default repository can be opened with
   179  <code>git browse -- commit/&lt;COMMIT></code>.
   180  With <code>-u</code>, outputs the URL rather than opening the browser.</p></dd>
   181  <dt><code>git compare</code> [<code>-u</code>] [<var>USER</var>] [[<var>START</var>...]<var>END</var>]</dt><dd><p>Open a GitHub compare view page in the system's default web browser.
   182  <var>START</var> to <var>END</var> are branch names, tag names, or commit SHA1s specifying
   183  the range of history to compare. If a range with two dots (<code>a..b</code>) is given,
   184  it will be transformed into one with three dots. If <var>START</var> is omitted,
   185  GitHub will compare against the base branch (the default is "master").
   186  If <var>END</var> is omitted, GitHub compare view is opened for the current branch.
   187  With <code>-u</code>, outputs the URL rather than opening the browser.</p></dd>
   188  <dt><code>git fork</code> [<code>--no-remote</code>]</dt><dd><p>Forks the original project (referenced by "origin" remote) on GitHub and
   189  adds a new remote for it under your username.</p></dd>
   190  <dt><code>git pull-request</code> [<code>-o</code>|<code>--browse</code>] [<code>-f</code>] [<code>-m</code> <var>MESSAGE</var>|<code>-F</code> <var>FILE</var>|<code>-i</code> <var>ISSUE</var>|<var>ISSUE-URL</var>] [<code>-b</code> <var>BASE</var>] [<code>-h</code> <var>HEAD</var>]</dt><dd><p>Opens a pull request on GitHub for the project that the "origin" remote
   191  points to. The default head of the pull request is the current branch.
   192  Both base and head of the pull request can be explicitly given in one of
   193  the following formats: "branch", "owner:branch", "owner/repo:branch".
   194  This command will abort operation if it detects that the current topic
   195  branch has local commits that are not yet pushed to its upstream branch
   196  on the remote. To skip this check, use <code>-f</code>.</p>
   197  
   198  <p>Without <var>MESSAGE</var> or <var>FILE</var>, a text editor will open in which title and body
   199  of the pull request can be entered in the same manner as git commit message.
   200  Pull request message can also be passed via stdin with <code>-F -</code>.</p>
   201  
   202  <p>With <code>-o</code> or <code>--browse</code>, the new pull request will open in the web browser.</p>
   203  
   204  <p>Issue to pull request conversion via <code>-i &lt;ISSUE></code> or <var>ISSUE-URL</var>
   205  arguments is deprecated and will likely be removed from the future versions
   206  of both hub and GitHub API.</p></dd>
   207  <dt><code>git ci-status</code> [<code>-v</code>] [<var>COMMIT</var>]</dt><dd><p>Looks up the SHA for <var>COMMIT</var> in GitHub Status API and displays the latest
   208  status. Exits with one of:<br />
   209  success (0), error (1), failure (1), pending (2), no status (3)</p>
   210  
   211  <p>If <code>-v</code> is given, additionally print the URL to CI build results.</p></dd>
   212  </dl>
   213  
   214  
   215  <h2 id="CONFIGURATION">CONFIGURATION</h2>
   216  
   217  <h3 id="GitHub-OAuth-authentication">GitHub OAuth authentication</h3>
   218  
   219  <p>Hub will prompt for GitHub username &amp; password the first time it needs to access
   220  the API and exchange it for an OAuth token, which it saves in "~/.config/hub".</p>
   221  
   222  <p>To avoid being prompted, use <var>GITHUB_USER</var> and <var>GITHUB_PASSWORD</var> environment
   223  variables.</p>
   224  
   225  <h3 id="HTTPS-instead-of-git-protocol">HTTPS instead of git protocol</h3>
   226  
   227  <p>If you prefer the HTTPS protocol for GitHub repositories, you can set
   228  "hub.protocol" to "https". This will affect <code>clone</code>, <code>fork</code>, <code>remote add</code>
   229  and other operations that expand references to GitHub repositories as full
   230  URLs that otherwise use git and ssh protocols.</p>
   231  
   232  <p>"hub.protocol" only applies when the "OWNER/REPO" shorthand is used instead of
   233  a full git URL.</p>
   234  
   235  <pre><code># default behavior
   236  $ git clone defunkt/repl
   237  &lt; git clone >
   238  
   239  # opt into HTTPS:
   240  $ git config --global hub.protocol https
   241  $ git clone defunkt/repl
   242  &lt; https clone >
   243  </code></pre>
   244  
   245  <h3 id="GitHub-Enterprise">GitHub Enterprise</h3>
   246  
   247  <p>By default, hub will only work with repositories that have remotes which
   248  point to github.com. GitHub Enterprise hosts need to be whitelisted to
   249  configure hub to treat such remotes same as github.com:</p>
   250  
   251  <pre><code>$ git config --global --add hub.host my.git.org
   252  </code></pre>
   253  
   254  <p>The default host for commands like <code>init</code> and <code>clone</code> is still
   255  github.com, but this can be affected with the <code>GITHUB_HOST</code> environment
   256  variable:</p>
   257  
   258  <pre><code>$ GITHUB_HOST=my.git.org git clone myproject
   259  </code></pre>
   260  
   261  <h2 id="EXAMPLES">EXAMPLES</h2>
   262  
   263  <h3 id="git-clone">git clone</h3>
   264  
   265  <pre><code>$ git clone schacon/ticgit
   266  &gt; git clone git://github.com/schacon/ticgit.git
   267  
   268  $ git clone -p schacon/ticgit
   269  &gt; git clone git@github.com:schacon/ticgit.git
   270  
   271  $ git clone resque
   272  &gt; git clone git@github.com/YOUR_USER/resque.git
   273  </code></pre>
   274  
   275  <h3 id="git-remote-add">git remote add</h3>
   276  
   277  <pre><code>$ git remote add rtomayko
   278  &gt; git remote add rtomayko git://github.com/rtomayko/CURRENT_REPO.git
   279  
   280  $ git remote add -p rtomayko
   281  &gt; git remote add rtomayko git@github.com:rtomayko/CURRENT_REPO.git
   282  
   283  $ git remote add origin
   284  &gt; git remote add origin git://github.com/YOUR_USER/CURRENT_REPO.git
   285  </code></pre>
   286  
   287  <h3 id="git-fetch">git fetch</h3>
   288  
   289  <pre><code>$ git fetch mislav
   290  &gt; git remote add mislav git://github.com/mislav/REPO.git
   291  &gt; git fetch mislav
   292  
   293  $ git fetch mislav,xoebus
   294  &gt; git remote add mislav ...
   295  &gt; git remote add xoebus ...
   296  &gt; git fetch --multiple mislav xoebus
   297  </code></pre>
   298  
   299  <h3 id="git-cherry-pick">git cherry-pick</h3>
   300  
   301  <pre><code>$ git cherry-pick http://github.com/mislav/REPO/commit/SHA
   302  &gt; git remote add -f mislav git://github.com/mislav/REPO.git
   303  &gt; git cherry-pick SHA
   304  
   305  $ git cherry-pick mislav@SHA
   306  &gt; git remote add -f mislav git://github.com/mislav/CURRENT_REPO.git
   307  &gt; git cherry-pick SHA
   308  
   309  $ git cherry-pick mislav@SHA
   310  &gt; git fetch mislav
   311  &gt; git cherry-pick SHA
   312  </code></pre>
   313  
   314  <h3 id="git-am-git-apply">git am, git apply</h3>
   315  
   316  <pre><code>$ git am https://github.com/defunkt/hub/pull/55
   317  [ downloads patch via API ]
   318  &gt; git am /tmp/55.patch
   319  
   320  $ git am --ignore-whitespace https://github.com/davidbalbert/hub/commit/fdb9921
   321  [ downloads patch via API ]
   322  &gt; git am --ignore-whitespace /tmp/fdb9921.patch
   323  
   324  $ git apply https://gist.github.com/8da7fb575debd88c54cf
   325  [ downloads patch via API ]
   326  &gt; git apply /tmp/gist-8da7fb575debd88c54cf.txt
   327  </code></pre>
   328  
   329  <h3 id="git-fork">git fork</h3>
   330  
   331  <pre><code>$ git fork
   332  [ repo forked on GitHub ]
   333  &gt; git remote add -f YOUR_USER git@github.com:YOUR_USER/CURRENT_REPO.git
   334  </code></pre>
   335  
   336  <h3 id="git-pull-request">git pull-request</h3>
   337  
   338  <pre><code># while on a topic branch called "feature":
   339  $ git pull-request
   340  [ opens text editor to edit title &amp; body for the request ]
   341  [ opened pull request on GitHub for "YOUR_USER:feature" ]
   342  
   343  # explicit title, pull base &amp; head:
   344  $ git pull-request -m "Implemented feature X" -b defunkt:master -h mislav:feature
   345  </code></pre>
   346  
   347  <h3 id="git-checkout">git checkout</h3>
   348  
   349  <pre><code>$ git checkout https://github.com/defunkt/hub/pull/73
   350  &gt; git remote add -f -t feature mislav git://github.com/mislav/hub.git
   351  &gt; git checkout --track -B mislav-feature mislav/feature
   352  
   353  $ git checkout https://github.com/defunkt/hub/pull/73 custom-branch-name
   354  </code></pre>
   355  
   356  <h3 id="git-merge">git merge</h3>
   357  
   358  <pre><code>$ git merge https://github.com/defunkt/hub/pull/73
   359  &gt; git fetch git://github.com/mislav/hub.git +refs/heads/feature:refs/remotes/mislav/feature
   360  &gt; git merge mislav/feature --no-ff -m 'Merge pull request #73 from mislav/feature...'
   361  </code></pre>
   362  
   363  <h3 id="git-create">git create</h3>
   364  
   365  <pre><code>$ git create
   366  [ repo created on GitHub ]
   367  &gt; git remote add origin git@github.com:YOUR_USER/CURRENT_REPO.git
   368  
   369  # with description:
   370  $ git create -d 'It shall be mine, all mine!'
   371  
   372  $ git create recipes
   373  [ repo created on GitHub ]
   374  &gt; git remote add origin git@github.com:YOUR_USER/recipes.git
   375  
   376  $ git create sinatra/recipes
   377  [ repo created in GitHub organization ]
   378  &gt; git remote add origin git@github.com:sinatra/recipes.git
   379  </code></pre>
   380  
   381  <h3 id="git-init">git init</h3>
   382  
   383  <pre><code>$ git init -g
   384  &gt; git init
   385  &gt; git remote add origin git@github.com:YOUR_USER/REPO.git
   386  </code></pre>
   387  
   388  <h3 id="git-push">git push</h3>
   389  
   390  <pre><code>$ git push origin,staging,qa bert_timeout
   391  &gt; git push origin bert_timeout
   392  &gt; git push staging bert_timeout
   393  &gt; git push qa bert_timeout
   394  </code></pre>
   395  
   396  <h3 id="git-browse">git browse</h3>
   397  
   398  <pre><code>$ git browse
   399  &gt; open https://github.com/YOUR_USER/CURRENT_REPO
   400  
   401  $ git browse -- commit/SHA
   402  &gt; open https://github.com/YOUR_USER/CURRENT_REPO/commit/SHA
   403  
   404  $ git browse -- issues
   405  &gt; open https://github.com/YOUR_USER/CURRENT_REPO/issues
   406  
   407  $ git browse -- issues/10
   408  &gt; open https://github.com/YOUR_USER/CURRENT_REPO/issues/10
   409  
   410  $ git browse schacon/ticgit
   411  &gt; open https://github.com/schacon/ticgit
   412  
   413  $ git browse schacon/ticgit commit/SHA
   414  &gt; open https://github.com/schacon/ticgit/commit/SHA
   415  
   416  $ git browse resque
   417  &gt; open https://github.com/YOUR_USER/resque
   418  
   419  $ git browse resque network
   420  &gt; open https://github.com/YOUR_USER/resque/network
   421  </code></pre>
   422  
   423  <h3 id="git-compare">git compare</h3>
   424  
   425  <pre><code>$ git compare refactor
   426  &gt; open https://github.com/CURRENT_REPO/compare/refactor
   427  
   428  $ git compare 1.0..1.1
   429  &gt; open https://github.com/CURRENT_REPO/compare/1.0...1.1
   430  
   431  $ git compare -u fix
   432  &gt; (https://github.com/CURRENT_REPO/compare/fix)
   433  
   434  $ git compare other-user patch
   435  &gt; open https://github.com/other-user/REPO/compare/patch
   436  </code></pre>
   437  
   438  <h3 id="git-submodule">git submodule</h3>
   439  
   440  <pre><code>$ git submodule add wycats/bundler vendor/bundler
   441  &gt; git submodule add git://github.com/wycats/bundler.git vendor/bundler
   442  
   443  $ git submodule add -p wycats/bundler vendor/bundler
   444  &gt; git submodule add git@github.com:wycats/bundler.git vendor/bundler
   445  
   446  $ git submodule add -b ryppl --name pip ryppl/pip vendor/pip
   447  &gt; git submodule add -b ryppl --name pip git://github.com/ryppl/pip.git vendor/pip
   448  </code></pre>
   449  
   450  <h3 id="git-ci-status">git ci-status</h3>
   451  
   452  <pre><code>$ git ci-status [commit]
   453  &gt; (prints CI state of commit and exits with appropriate code)
   454  &gt; One of: success (0), error (1), failure (1), pending (2), no status (3)
   455  </code></pre>
   456  
   457  <h3 id="git-help">git help</h3>
   458  
   459  <pre><code>$ git help
   460  &gt; (improved git help)
   461  $ git help hub
   462  &gt; (hub man page)
   463  </code></pre>
   464  
   465  <h2 id="BUGS">BUGS</h2>
   466  
   467  <p><a href="https://github.com/github/hub/issues" data-bare-link="true">https://github.com/github/hub/issues</a></p>
   468  
   469  <h2 id="AUTHORS">AUTHORS</h2>
   470  
   471  <p><a href="https://github.com/github/hub/contributors" data-bare-link="true">https://github.com/github/hub/contributors</a></p>
   472  
   473  <h2 id="SEE-ALSO">SEE ALSO</h2>
   474  
   475  <p><span class="man-ref">git<span class="s">(1)</span></span>, <span class="man-ref">git-clone<span class="s">(1)</span></span>, <span class="man-ref">git-remote<span class="s">(1)</span></span>, <span class="man-ref">git-init<span class="s">(1)</span></span>,
   476  <a href="http://github.com" data-bare-link="true">http://github.com</a>,
   477  <a href="https://github.com/github/hub" data-bare-link="true">https://github.com/github/hub</a></p>
   478  
   479  
   480    <ol class='man-decor man-foot man foot'>
   481      <li class='tl'>GITHUB</li>
   482      <li class='tc'>January 2015</li>
   483      <li class='tr'>hub(1)</li>
   484    </ol>
   485  
   486    </div>
   487  </body>
   488  </html>