Shell Ruby Vim script HTML
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
i3-gaps @ 660d094


This is a collection of dotfiles that should make your day to day work easier, if you see any errors or wish to contribute feel free to fork, open an issue or send a pull request.


We try to keep installing as simple as possible by keeping the steps to a minimum and our dotfiles as backward compatible across the couple of OS we use the most.

Online installer

We provide a simple online installer, if you're running Ubuntu, Debian or OSX, it will automatically try to resolve dependencies, install rbenv, install homebrew or linuxbrew depending on the OS you're running; if your OS is not supported you can still resolve dependencies and generate the files manually.

curl | sh

Check our developers section of this README to learn how to run the installer in a virtual machine.

Github checkout

If you want to resolve dependencies on your own, you can install by doing a simple github checkout.

# We like to keep dotfiles somewhere in $HOME but you can clone anywhere you have permission to
git clone ~/.dotfiles

cd ~/.dotfiles
bundle install

Your original dotfiles will be renamed to name.orig so you can always restore them.


Our uninstall script is still a work in progress, to run it simply do run the uninstall task from your dotfiles folder.

rake uninstall

Afterwards you can optionally rm -fr ~/.dotifiles if you wish, your name.orig files will be restored by having run rake uninstall.


Only if you don't run the install script provided

gem install bundler

Getting ruby

We recommend getting ruby via rbenv and ruby-build. This is the way our remote installer installs ruby, however this is not mandatory; you can install ruby in anyway you want.

Upgrade single bits

If you already have dotfiles installed (all symlinks have been created) you can upgrade small bits like this:

cd  ~/.dotfiles
git pull
rake bash # bash being the bit you wish to upgrade

If you don't know what bits are available in dotfiles; simply run rake -T for a full list of tasks.

Commands that will make this enjoyable

These dotfiles include configuration tweaks for:

  • ncmpcpp
  • bash
  • rubygems
  • git
  • vim
  • tmux
  • postgresql
  • ack

To get most of these dotfiles we recommend installing these packages


Homebrew makes managing and installing packages in both Linux and OSX pretty simple. This is not required for Linux since most distributions have a pretty robust package manager; hoewever homebrew allows you to install packages directly into $HOME without special permissions, and in many cases unavailable or newer packages that your OS package manager does not include.

You can install each of this with a simple brew install <package>.

OSX with Homebrew

If you're on a mac we highly recommend using Homebrew, it's constantly getting updates and it's pretty clean and easy to manage, here's a list of packages you should be looking to install.

  • git
  • coreutils
  • vim
  • macvim
  • readline
  • openssl

Linux with [Linuxbrew] (

If you're using linux and would like to install packages to your $HOME then Linuxbrew is a simple way to get this done, like homebrew it gets frequent updates and it's pretty clean and easy to maintain, not to mention it has formulas for many of the same packages homebrew does, should a package not be present it's only a matter of falling back to the OS package manger.


We try to make development as simple as possible for ourselves, therefore we've worked in a way of easily running our scripts in a virtual machine that we can use a sandbox our installer can be ran from vagrant.

To start playing with our setup you'll need vagrant and virtualbox, you can use hombrew's brew cask install vagrant virtualbox in OSX if you already have homebrew installed or download the installers provided for your OS in both of the official sites.

git clone
cd dotfiles

# This will run vagrant in the background and setup a test box or boot it if you already have one
vagrant up

# This will connect you to your new virtual machine via ssh
vagrant ssh

Once in vagrant, your project folder will be synced into your VM's /vagrant folder, that means you do not need to exit ssh to make changes or disconnect if you do change something in your OS; You can run the installer from /vagrant and even pass it the name of the branch to install like this:

# Run installer from the /vagrant folder
/vagrant/install features/my-cool-feature

# Log out and log back in or load ~/.bash_profile
source ~/.bash_profile

When you're done you can shutdown vagrant by running vagrant halt.


These dotfiles are still in the works and are not perfect, feel free to advise, fork and send your pull requests.