Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

253 lines (203 sloc) 8.737 kB
<!DOCTYPE html>
<meta http-equiv='content-type' value='text/html;charset=utf8'>
<meta name='generator' value='Ron/v0.3'>
<title>hub(1) -- git + hub = github</title>
<style type='text/css'>
body {margin:0}
#man, #man code, #man pre, #man tt, #man kbd, #man samp {
background:#fff; }
#man { max-width:89ex; text-align:justify; margin:0 25px 25px 25px }
#man h1, #man h2, #man h3 { color:#232221;clear:left }
#man h1 { font-size:28px; margin:15px 0 30px 0; text-align:center }
#man h2 { font-size:18px; margin-bottom:0; margin-top:10px; line-height:1.3; }
#man h3 { font-size:16px; margin:0 0 0 4ex; }
#man p, #man ul, #man ol, #man dl, #man pre { margin:0 0 18px 0; }
#man pre {
padding:5px 7px;
margin:0px 0 20px 0;
border-left:2ex solid #ddd}
#man pre + h2, #man pre + h3 {
#man h2 + pre, #man h3 + pre {
#man > p, #man > ul, #man > ol, #man > dl, #man > pre { margin-left:8ex; }
#man dt { margin:0; clear:left }
#man dt.flush { float:left; width:8ex }
#man dd { margin:0 0 0 9ex }
#man code, #man strong, #man b { font-weight:bold; color:#131211; }
#man pre code { font-weight:normal; color:#232221; background:inherit }
#man em, var, u {
font-style:normal; color:#333231; border-bottom:1px solid #999; }
#man { display:none; }
#man, #man li { margin:2px 0 10px 0; padding:0;
float:left; width:33%; list-style-type:none;
text-transform:uppercase; font-size:18px; color:#999;
#man { width:100%; }
#man { text-align:left }
#man { text-align:center;letter-spacing:4px }
#man { text-align:right }
#man a { color:#999 }
#man a:hover { color:#333231 }
<div id='man'>
<h1 class='man-title'>hub(1)</h1>
<ol class='head man'>
<li class='tl'>hub(1)</li>
<li class='tc'>Git Manual</li>
<li class='tr'>hub(1)</li>
<h2 id='NAME'>NAME</h2>
<p><code>hub</code> -- git + hub = github</p>
<p><code>hub</code> <var>COMMAND</var> <var>OPTIONS</var> <br>
<code>hub alias</code> [<code>-s</code>] <var>SHELL</var> <br>
<p><code>git init -g</code> <var>OPTIONS</var> <br>
<code>git clone</code> [<code>-p</code>] <var>OPTIONS</var> [<var>USER</var>/]<var>REPOSITORY</var> <var>DIRECTORY</var> <br>
<code>git remote add</code> [<code>-p</code>] <var>OPTIONS</var> <var>USER</var>[/<var>REPOSITORY</var>] <br>
<code>git browse</code> [<code>-p</code>] [<var>USER</var>/]<var>REPOSITORY</var> <br>
<code>git submodule add</code> [<code>-p</code>] <var>OPTIONS</var> [<var>USER</var>/]<var>REPOSITORY</var> <var>DIRECTORY</var></p>
<p><code>hub</code> enhances various <code>git</code> commands with GitHub remote expansion. The
alias command displays information on configuring your environment:</p>
<code>hub alias</code> [<code>-s</code>] <var>SHELL</var>
<dd>Writes shell aliasing code for <var>SHELL</var> (<code>bash</code>, <code>sh</code>, <code>zsh</code>,
<code>csh</code>) to standard output. With the <code>-s</code> option, the output of
this command can be evaluated directly within the shell:
<code>eval $(hub alias -s bash)</code>
<p>After configuring the alias, the following commands have superpowers:</p>
<code>git init</code> <code>-g</code> <var>OPTIONS</var>
<dd><p>Create a git repository as with git-init(1) and add remote <code>origin</code> at
"<var>USER</var>/<var>REPOSITORY</var>.git"; <var>USER</var> is your GitHub username and
<var>REPOSITORY</var> is the current working directory's basename.</p></dd>
<code>git clone</code> [<code>-p</code>] <var>OPTIONS</var> [<var>USER</var><code>/</code>]<var>REPOSITORY</var> <var>DIRECTORY</var>
<dd><p>Clone repository "git://<var>USER</var>/<var>REPOSITORY</var>.git" into
<var>DIRECTORY</var> as with git-clone(1). When <var>USER</var>/ is omitted, assumes
your GitHub login. With <code>-p</code>, use private remote
<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://<var>USER</var>/<var>REPOSITORY</var>.git" as with
git-remote(1). When /<var>REPOSITORY</var> is omitted, the basename of the
current working directory is used. With <code>-p</code>, use private remote
"<var>USER</var>/<var>REPOSITORY</var>.git". If <var>USER</var> is "origin"
then uses your GitHub login.</p></dd>
<code>git push</code> <var>REMOTE-1</var>,<var>REMOTE-2</var>,...,<var>REMOTE-N</var> <var>REF</var>
<dd><p>Push <var>REF</var> to each of <var>REMOTE-1</var> through <var>REMOTE-N</var> by executing
multiple <code>git push</code> commands.</p></dd>
<code>git browse</code> [<code>-p</code>] [[<var>USER</var><code>/</code>]<var>REPOSITORY</var>]</dt>
<dd><p>Open repository's GitHub page in the system's default web browser
using <code>open(1)</code> or the <code>BROWSER</code> env variable. Use <code>-p</code> to open a
page with https. If the repository isn't specified, <code>browse</code> opens
the page of the repository found in the current directory.</p></dd>
<code>git submodule add</code> [<code>-p</code>] <var>OPTIONS</var> [<var>USER</var>/]<var>REPOSITORY</var> <var>DIRECTORY</var>
<dd><p>Submodule repository "git://<var>USER</var>/<var>REPOSITORY</var>.git" into
<var>DIRECTORY</var> as with git-submodule(1). When <var>USER</var>/ is omitted, assumes
your GitHub login. With <code>-p</code>, use private remote
<dt><code>git help</code></dt>
<dd><p>Display enhanced git-help(1).</p></dd>
<p>Use git-config(1) to display the currently configured GitHub username:</p>
<pre><code>$ git config --global github.user
<p>Or, set the GitHub username with:</p>
<pre><code>$ git config --global github.user &lt;username&gt;
<p>See <a href=""></a> for more
<p>You can also tell <code>hub</code> to use <code>http://</code> rather than <code>git://</code> when
<pre><code>$ git config --global --add hub.http-clone yes
<h3>git clone</h3>
<pre><code>$ git clone schacon/ticgit
&gt; git clone git://
$ git clone -p schacon/ticgit
&gt; git clone
$ git clone resque
&gt; git clone git://
$ git clone -p resque
&gt; git clone
<h3>git remote add</h3>
<pre><code>$ git remote add rtomayko
&gt; git remote add rtomayko git://
$ git remote add -p rtomayko
&gt; git remote add rtomayko
$ git remote add origin
&gt; git remote add origin git://
<h3>git init</h3>
<pre><code>$ git init -g
&gt; git init
&gt; git remote add origin
<h3>git push</h3>
<pre><code>$ git push origin,staging,qa bert_timeout
&gt; git push origin bert_timeout
&gt; git push staging bert_timeout
&gt; git push qa bert_timeout
<h3>git browse</h3>
<pre><code>$ git browse schacon/ticgit
&gt; open
$ git browse -p schacon/ticgit
&gt; open
$ git browse resque
&gt; open
$ git browse -p resque
&gt; open
<h3>git help</h3>
<pre><code>$ git help
&gt; (improved git help)
$ git help hub
&gt; (hub man page)
<p><a href=""></a></p>
<p>Chris Wanstrath :: :: @defunkt</p>
<h2>SEE ALSO</h2>
<p>git(1), git-clone(1), git-remote(1), git-init(1),
<a href=""></a>,
<a href=""></a></p>
<ol class='foot man'>
<li class='tl'>DEFUNKT</li>
<li class='tc'>March 2010</li>
<li class='tr'>hub(1)</li>
Jump to Line
Something went wrong with that request. Please try again.