Created: 2008-03-09 01:56
Updated: 2018-09-28 15:23
License: mit


  • Git-Ruby Is Not Maintained * ==============================

The Git-Ruby project is no longer maintained by me. I will leave it up here for now, but almost all of this code has since been incorporated into the Grit project ( and works much, much better. If you're interested in using Git from Ruby, please check out Grit (specifically the schacon/grit fork) - it does as much as it can from Ruby and falls back to system calls if it needs to. The API is different, but the project is being actively maintained.

Git Library for Ruby

A pure ruby implementation of Git


Git public hosting of the project source code and project wiki is at:


I have included a command line pure-ruby git client called 'gitr'

The following commands are available - they all will run in pure ruby, without forking out the the git binary. In fact, they can be run on a machine without git compiled on it.

Commands currently implemented:

  • add
  • commit
  • log
  • log-shas
  • cat-file (treeish)
  • rev-parse (treeish)
  • branches
  • ls-tree (tree)


Here are some of examples of how to use the Git-Ruby package.

First you have to remember to require rubygems if it's not. Then include the 'git-ruby' gem.

require 'rubygems'
require 'git-ruby'

g ='my_project')  # has a .git subdir

g.commit('commit message')

g.log.each do |commit|
  puts commit.sha
  puts commit.message

  commit.gtree.children.each do |name, obj|
    if obj.tree?
      puts ['tree: ' name, obj.sha].join("\t")

    if obj.blob?
      puts ['blob: ' name, obj.sha].join("\t")
Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more