Colourful & robust OS X configuration files and utilities.
Switch branches/tags
Nothing to show
Clone or download


Colourful & robust macOS configuration files and utilities.

Installation is done with simple command set (see “building system from scratch” for setup of new system):

curl --silent | sh


  1. Create ~/Developer/
  2. Change default shell to ZSH: chsh -s /bin/zsh.
  3. Install XCode.
  4. Clone this project (dotfiles RECURSIVELY --recursive) and run sh
  5. Change theme to terminal/paulmillr.terminal (Settings -> Profiles -> Press gear -> Import).
  6. Don't forget to change the git user in home/.gitconfig. That's it!


Shell (zsh):

  • Auto-completion
  • Syntax highlighting
  • Automatic setting up of terminal tab / window title to current dir
  • rm moves file to the macOS trash
  • A bunch of useful functions:
    • extract — unpack any archive (supports many extensions)
    • ram safari — show app RAM usage
    • openfiles — real-time disk usage monitoring with dtrace.
    • loc py coffee js html css — count lines of code in current dir in a colourful way.
    • ff file-name-or-pattern - fast recursive search for a file name in directories.
    • curl http://site/v1/api.json | json - pretty-print JSON
    • aes-enc, aes-dec - safely encrypt files.
  • Neat git extras:
    • Opinionated git log, git graph
    • gcp for fast git commit -m ... && git push
    • git pr <pull-req> [origin] for fetching pull request branches
    • git cleanup — clean up merged git branches. Very useful if you’re doing github pull requests in topic branches.
    • git summary — outputs commit email statistics.
    • git release — save changes, tag commit. If used on node.js project, also push to npm.
    • git url - opens GitHub repo for current git repo.
    • git-changelog, git-setup etc.
  • homesick / homeshick-compatible


  • etc — various stuff like macOS text substitutions / hosts backup
  • git-extras — useful git functions, defined in home/gitconfig. Don't forget to change your git author to a proper name.
  • home — files that are symlinked to $HOME directory
  • sublime — sublime text theme & settings
  • terminal — terminal theme & prompt



MIT (c) 2016 Paul Miller (