Skip to content
Ryan McGeary's configuration shiznit that makes him productive
Emacs Lisp Shell Lua Ruby VimL
Find file
New pull request

Getting Started

Clone this (or a forked version of this) repository.

$ cd ~
$ git clone .dotfiles

(Option 1) If you'd like to symlink everything from this repository to your home directory, run install.rb. This will also sync and update all the git submodules within.

$ cd ~/.dotfiles
$ ./install.rb

This install script is idempotent, meaning you can run it over and over again without fear of breaking anything. Use it as an installer or to upgrade after merging from an upstream fork.

(Option 2) If you'd like to just symlink one or more configurations to your home directory manually, you can. If you take this approach, you'll have to update all the git submodules manually.

$ cd ~/.dotfiles
$ git submodule sync
$ git submodule update --init --recursive
$ ln -ns emacs   ~/.emacs
$ ln -ns emacs.d ~/.emacs.d

(Option 3) Just look around and pick and choose what you like for your own dotfiles.


If you'd like to use git and github, be sure to add your own ~/.gitconfig_local file:

  email =
  name = Your Name
  user = your-github-username


  • *nix environment (e.g. Mac OS X or Linux)
  • Bash version >= 3 (for command line enhancements)
  • Emacs version >= 24 (for emacs config and setup)
  • Ruby (for the install.rb to work)
Something went wrong with that request. Please try again.