Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Opinionated configuration files powered by Ansible.
Python Ruby Shell Perl Clojure Haskell Other

Avoid updating Spacemacs automatically

Because Ansible will checkout some unknown, out-of-sync version of the
develop branch that is missing loads of functionality and breaks Emacs.
latest commit 352e568644
@jcf authored


Dotfiles helps you get your dev environment up and running.


What's in the box?

The following repositories are pulled in and setup:

  • emacs.d holds all of my Evil Emacs config.
  • prezto configures zsh.
  • vimrc sets up Vim for those times when Emacs isn't available.

And there's pretty good support for the following languages:

Each feature/language is grouped using Ansible roles, and can be found in the roles directory.

All the dotfiles that get linked into $HOME are grouped by language or feature where possible, and failing that lumped into the dotfiles role.

Roles look at the vars kept in group_vars for things like packages to install, and versions of certain runtime environments.

Getting Started

You'll need the following dependencies before getting started.

At the time of writing it's possible to get all three like so:

sudo python

ruby -e "$(curl -fsSL"

xcode-select --install


With the dependencies above installed you can clone the repo, and use Ansible to get everything setup!

git clone git:// ~/.dotfiles
cd ~/.dotfiles


# This needs root access and will ask for your password


To update the installed packages and tools you can use bin/update, which internally runs all Ansible tasks with the tag update.

Something went wrong with that request. Please try again.