by g2p

g2p / git-fs

A filesystem interface to git repositories

214 Stars 20 Forks Last release: Not found GNU General Public License v2.0 142 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


git-fs is a filesystem interface to git repositories.

Past and current versions can be accessed without a checkout. Heads, tags, branches, reflogs, commits and worktrees provide various means of naming and accessing files.

Use cases

You can try these on the git.git repository.

Compute repository statistics

How much code in the first major release?

git fs
cd .git/fs/tags/v1.0.0/worktree
ohcount # A sloccount alternative

Display the latest html docs

git fs; cd .git/fs
firefox remotes/origin/html/worktree/index.html

Jump to a commit using its SHA1

git fs; cd .git/fs
cd commits/902f235378cb2b2f6dd5dd664b9630c95321f0ae


  • Restore from backup (bup, gibak)
  • Look at previous conffiles stored in etckeeper
  • Look at wiki pages stored by ikiwiki or gh-pages
  • Serve repository snapshots using a standard webserver.

Build instructions

git-fs depends on FUSE and some OCaml libraries. It has been tested on Debian, Ubuntu, and ArchLinux.

Get the dependencies:

sudo apt-get install omake libfuse-dev camlidl libpcre-ocaml-dev libbatteries-ocaml-dev  # Ubuntu
sudo aptitude install omake libfuse-dev camlidl libpcre-ocaml-dev libbatteries-ocaml-dev  # Debian
sudo pacman -S omake ocamlfuse-cvs pcre-ocaml ocaml-batteries  # Arch
sudo yum install fuse-devel ocaml-pcre-devel ocaml-findlib-devel ocaml-camomile ocaml-camlidl ocaml-bisect ocaml-ounit ocaml-ocamldoc  # Fedora


git submodule update --init
make -C deps/ocamlfuse/lib || make -C deps/ocamlfuse/lib byte-code-library

Install (~/bin must be in your path):

ln -s ~+/git-fs -t ~/bin


The first step is to mount the filesystem.

git fs

Then, either browse it

cd .git/fs/HEAD/worktree

Or use a few special commands

git fs mtab
git fs umount
git fs help


MALLOC_CHECK_=3 debug/git-fs debug 2>&1 |tee -a debug.log

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.