🔧 The very heart of an efficient work environment
Vim script Shell R Python Ruby Perl
Switch branches/tags
Nothing to show
Clone or download


                       __      __  _____ __
                  ____/ /___  / /_/ __(_) /__  _____
                 / __  / __ \/ __/ /_/ / / _ \/ ___/
                / /_/ / /_/ / /_/ __/ / /  __(__  )
                \__,_/\____/\__/_/ /_/_/\___/____/

Proper dotfiles are the very heart of an efficient working environment.

This repository ships a set of configuration files for modern command line tools, such as tmux, vim, and zsh. Additionally, it provides a portable script for managing dotfiles and quickly getting up and runninng on a new machine.


Begin with cloning this repository somewhere:

git clone git@github.com:mavam/dotfiles.git ~/.dotfiles
cd .dotfiles

Dotfile Management

The POSIX shell script dots installs (= symlinks) and removes subsets of dotfiles according to your needs. For example, install all dotfiles as follows:

./dots install -a

Alternatively, install only dotfiles for vim and zsh:

./dots install vim zsh

Similarly, remove all installed dotfiles:

./dots uninstall -a

The installer script does not override existing dotfiles unless the command line includes the -f switch. When in doubt what the installation of a subset of the dotfiles would look like, it is possible to look at the diff first:

./dots diff -a

System Bootstrapping

In addition to managing dotfiles, the script bootstrap facilitates getting up and running on a new machine. Passing -h shows the available aspects available for configuration:

  1. system: adjust system defaults for productivity
  2. homebrew:setup Homebrew and install bundled packages
  3. dotfiles: setup dotfiles via ./dots install -a
  4. postfix: setup postfix as GMail relay
  5. tmux: install tmux plugins
  6. vim: install vim plugins
  7. zsh: setup zsh as login shell



without any arguments sets up all aspects in the above order. On macOS, (1) includes:

  1. Adjust various default settings, e.g.:
    • Improve security and privacy settings
    • Disable boot sound
    • Reduce UI effects for improved speed
    • Make the keyboard faster
  2. Perform a software update
  3. Install XCode



My browser is Safari, which I beef up with the following enhancements:

Browse through this curated list of extensions for further inspiration.