3.1 KiB
hub: git + hub = github
hub is a command line utility which injects git with GitHub
knowledge.
It can used on its own or can serve as a complete, backwards
compatible replacement for the git script.
Normal:
$ hub clone rtomayko/tilt
Initialized empty Git repository in /Users/chris/sandbox/tilt/.git/
remote: Counting objects: 307, done.
remote: Compressing objects: 100% (219/219), done.
remote: Total 307 (delta 175), reused 85 (delta 45)
Receiving objects: 100% (307/307), 48.91 KiB, done.
Resolving deltas: 100% (175/175), done.
Aliased:
$ git clone rack/rack
Initialized empty Git repository in /Users/chris/sandbox/rack/.git/
remote: Counting objects: 4005, done.
remote: Compressing objects: 100% (1738/1738), done.
remote: Total 4005 (delta 2505), reused 3620 (delta 2208)
Receiving objects: 100% (4005/4005), 785.82 KiB | 129 KiB/s, done.
Resolving deltas: 100% (2505/2505), done.
Install
hub can be installed most easily as a stand alone script:
curl http://defunkt.github.com/hub/standalone > ~/bin/hub && chmod 0755 !$
hub can be installed using rubygems:
$ gem install hub -s http://gemcutter.org/
Or installed from source:
$ git clone git://github.com/defunkt/hub.git
$ cd hub
$ rake install
Once you've installed hub, you can invoke it directly from the
command line:
$ hub --version
To get the full experience, alias your git command to run hub by
placing the following in your .bash_profile (or relevant startup
script):
alias git=hub
Typing hub install <shell> will display install instructions for you
shell.
Commands
git clone
$ git clone schacon/ticgit
> git clone git://github.com/schacon/ticgit.git
$ git clone -p schacon/ticgit
> git clone git@github.com:schacon/ticgit.git
git remote add
$ git remote add rtomayko
> git remote add rtomayko git://github.com/rtomayko/CURRENT_REPO.git
$ git remote add -p pjhyett
> git remote add rtomayko git@github.com:rtomayko/CURRENT_REPO.git
git init
$ git init -g
> git init
> git remote add origin git@github.com:USER/REPO.git
git help
$ git help
> (improved git help)
Prior Art
These projects also aim to either improve git or make interacting with GitHub simpler:
Contributing
Once you've made your great commits:
- Fork hub
- Create a topic branch -
git checkout -b my_branch - Push to your branch -
git push origin my_branch - Create an Issue with a link to your branch
- That's it!
Meta
- Code:
git clone git://github.com/defunkt/hub.git - Home: http://github.com/defunkt/hub
- Bugs: http://github.com/defunkt/hub/issues
- List: http://groups.google.com/group/github
- Gems: http://gemcutter.org/gems/hub
Author
Chris Wanstrath :: chris@ozmm.org :: @defunkt