zdotdir

My $ZDOTDIR dotfiles directory, which contains my zsh configuration.

My Terminal

My setup

Plugin manager:

antidote

Framework:

zephyr

Plugins:

See my .zplugins file

Installation

It's a good idea to backup existing files first:

setopt extended_glob
zfiles=(
  ${ZDOTDIR:-~}/.zsh*(.N)
  ${ZDOTDIR:-~}/.zlog*(.N)
  ${ZDOTDIR:-~}/.zprofile(.N)
)
mkdir -p ~/.bak
for zfile in $zfiles; do
  cp $zfile ~/.bak
done
unset zfile zfiles

Install this dotfiles repo to your $ZDOTDIR:

# set the amazing ZDOTDIR variable
export ZDOTDIR=~/.config/zsh

# clone this repo
git clone --recursive git@github.com:mattmc3/zdotdir.git $ZDOTDIR

# change the root .zshenv file to use ZDOTDIR
cat << 'EOF' >| ~/.zshenv
export ZDOTDIR=~/.config/zsh
[[ -f $ZDOTDIR/.zshenv ]] && . $ZDOTDIR/.zshenv
EOF

# load zsh
zsh

Performance

A snappy shell is very important. My config includes a zbench alias that runs zsh 10 times and presents the timings.

The latest benchmark run shows that we load a new shell pretty fast.

% # MacBook Air (M1, 2020)
% for i in $(seq 10); do; /usr/bin/time zsh -lic exit; done
        0.06 real         0.03 user         0.02 sys
        0.04 real         0.02 user         0.01 sys
        0.04 real         0.02 user         0.01 sys
        0.04 real         0.02 user         0.01 sys
        0.04 real         0.02 user         0.01 sys
        0.04 real         0.02 user         0.01 sys
        0.04 real         0.02 user         0.02 sys
        0.04 real         0.02 user         0.01 sys
        0.04 real         0.02 user         0.01 sys
        0.04 real         0.02 user         0.01 sys

% # pure prompt
% zsh-bench
==> benchmarking login shell of user matt ...
creates_tty=0
has_compsys=1
has_syntax_highlighting=0
has_autosuggestions=1
has_git_prompt=0
first_prompt_lag_ms=24.480
first_command_lag_ms=93.093
command_lag_ms=60.182
input_lag_ms=7.144
exit_time_ms=41.945

Look-and-feel

Fonts

Install nerd fonts via homebrew:

brew tap homebrew/cask-fonts
brew install --cask font-meslo-lg-nerd-font
brew install --cask font-fira-code-nerd-font
brew install --cask font-hack-nerd-font
brew install --cask font-inconsolata-nerd-font
brew install --cask font-sauce-code-pro-nerd-font

Color schemes

iTerm2 has some awesome color schemes. You can use them for more than just iTerm2.

I use Space Gray:

chicken-suop/zdotdir