by matthewmccullough

matthewmccullough / dotfiles

Shell Config

198 Stars 80 Forks Last release: Not found Other 268 Commits 1 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:

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.