Awesome Open Source
Awesome Open Source


MIT License GitHub Stars

I have tested these dotfiles primarily on

  • Windows
    • MSYS2 with mintty
    • Cygwin with mintty
    • The Windows Subsystem for Linux (versions 1 and 2) with Windows Terminal
  • Linux
    • Ubuntu/Raspbian (based on Debian)
    • CloudLinux (based on CentOS)
    • Alpine Linux
  • BSD
    • FreeBSD
    • NetBSD
    • OpenBSD
    • DragonFly BSD
  • Unix
    • Solaris 11
    • OpenIndiana


  • .profile and .shrc are POSIX-compliant. They provide settings common to most shells and are sourced by the relevant zsh and bash dotfiles.
  • Everything is in vi-mode, although in zsh there are additional key bindings borrowed from emacs-mode.
  • The tmux and screen prefix key is Ctrl-Q (flow control has been disabled to allow this key binding). If you don't need flow control, Ctrl-Q is ideal: it does not interfere with any known application's key combinations.
  • Zenburn colors are used whenever possible (in Vim, obviously, as well as in tmux, ls, grep, and mintty -- also see my Zenburn Color Schemes for Windows Terminal).


Clone this repository to a ~/dotfiles directory (the directory name is hard-coded at the moment) and run the installation script:

git clone "${HOME}/dotfiles"
cd "${HOME}/dotfiles"

That will copy relevant configuration files to your home directory. The files copied depend on what shells or other programs you have installed on your system, so if you install others in the future, run the installation script again or type


in any POSIX-compliant shell. update_dotfiles is a function that pulls in the latest commits to my dotfiles repository and does what is necessary to update the system.

My .zshrc also provides a zsh_update function that runs update_dotfiles and then uses my own plugin manager (zcomet) to update the various plugins.

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Shell (171,125
Vim (18,659
Dotfiles (10,788
Zsh (7,266
Tmux (3,879
Vimrc (2,249
Zshrc (720
Mintty Color Schemes (4