.files, including ~/.osx — sensible hacker defaults for OS X

Mathias’s dotfiles


Using Git and the bootstrap script

You can clone the repository wherever you want. (I like to keep it in ~/Projects/dotfiles, with ~/dotfiles as a symlink.) The bootstrapper script will pull in the latest version and copy the files to your home folder.

git clone && cd dotfiles && ./

To update, cd into your local dotfiles repository and then:


Alternatively, to update while avoiding the confirmation prompt:

./ -f

Git-free install

To install these dotfiles without Git:

cd; curl -#L | tar -xzv --strip-components 1 --exclude={,}

To update later on, just run that command again.

Add custom commands without creating a new fork

If ~/.extra exists, it will be sourced along with the other files. You can use this to add a few custom commands without the need to fork this entire repository, or to add commands you don’t want to commit to a public repository.

My ~/.extra looks something like this:

# PATH additions
export PATH="~/bin:$PATH"

# Git credentials
# Not in the repository, to prevent people from accidentally committing under my name
GIT_AUTHOR_NAME="Mathias Bynens"
git config --global "$GIT_AUTHOR_NAME"
GIT_AUTHOR_EMAIL="[email protected]"
git config --global "$GIT_AUTHOR_EMAIL"

Sensible OS X defaults

When setting up a new Mac, you may want to set some sensible OS X defaults:


Install Homebrew formulae

When setting up a new Mac, you may want to install some common Homebrew formulae (after installing Homebrew, of course):



Suggestions/improvements welcome!

Thanks to…

Related Repositories



:+1: This is a collection of configuration files in my home directory :smiley_cat: ...



.files ...



The best vim,git,zsh plugins and the cleanest vimrc you've ever seen ...



Arch, Sway (Wayland :+1:), urxvt, fish, Neovim, ranger, etc. ...



YADR - The best vim,git,zsh plugins and the cleanest vimrc you've ever seen ...

Top Contributors

mathiasbynens matijs user996015 paulirish pkruithof sjonnet19 hongymagic richo alex-humphreys KeyboardCowboy clee danawoodman dmiedema gburtini nimbling janmoesen jpsirois jessejlt jrk kevinlawler kitcambridge atdt wimleers aristidesfl ekinertac iloveitaly yaykyle nikolavp