Need help with dotfiles?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

201 Stars 80 Forks Other 277 Commits 1 Opened issues


My shell configuration

Services available


Need anything else?

Contributors list

# 33,981
253 commits

What is this?

These are Matthew McCullough's shell configuration dotfiles. The primary goal is to increase CLI productivity on Mac OSX, though many scripts run just fine on any POSIX implementation.


The focus is on Zshell support, but there are plenty of cross-platform scripts in here. There are a few bash-specific ones.


The contents of this repo have been partly invented from scratch, partly inspired by open source projects, and partly refactored from snippets from colleagues and friends. Many are attributed.

Acquiring This Repo

This project contains submodules. It is suggested that you clone this into your home directory.

cd ~
git clone --recurse-submodules .dotfiles


There is a set up script that establishes the symlinks in your home directory. Run this once.

  • For ZShell ~/.dotfiles/_setupdotfiles.zsh
  • For Bash (needs some fixes) ~/.dotfiles/_setupdotfiles.bsh

NOTE: Some personal configuration of Matthew's will remain after setup. These dotfiles are intended for your inspiration, forking, and for you to tweak to your specific needs.

Non-automated, non-captured config

Reminder-to-self: Some additional personalization lives in the

directory. Specifically, the
file for
. It is not yet in scope for capture or copy, but some uers have shared their configuration in a Gist.


Contributions are always welcome in the form of pull requests with explanatory comments.

Loathing, Mehs and Praise

  1. Loathing should be directed into pull requests that make it better.
  2. Bugs with the setup should be put as GitHub issues.
  3. Mehs should be directed to /dev/null
  4. Praise should be directed to @matthewmccull on Twitter

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.