Dotfiles

zsh + oh-my-zsh

Installation

System

1. Homebrew

2. Git brew install git

3. Oh My Zsh (required)

   • sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

4. Clone repo in home directory, then run: install.zsh

Reload shell configuration

After running install.zsh, reload your shell so $ZSH_CUSTOM is set:

source ~/.zshrc

Zsh

Important:

• Built-in Oh My Zsh themes (e.g. robbyrussell) require no installation
• Only custom themes should be installed to dotfiles/custom/themes/
• Plugins must be installed to dotfiles/custom/plugins/

Theme

This setup uses the built-in Oh My Zsh theme:

ZSH_THEME="robbyrussell"

Plugins

This repo defines $ZSH_CUSTOM="$HOME/dotfiles/custom". The custom/plugins/ and custom/themes/ directories already exist and are gitignored.

Install plugins into custom/plugins/:

1. zsh-autosuggestions

   • git clone https://github.com/zsh-users/zsh-autosuggestions "$ZSH_CUSTOM/plugins/zsh-autosuggestions"

2. zsh-autocomplete

   • git clone https://github.com/marlonrichert/zsh-autocomplete "$ZSH_CUSTOM/plugins/zsh-autocomplete"

3. zsh-nvm

   • git clone https://github.com/lukechilds/zsh-nvm "$ZSH_CUSTOM/plugins/zsh-nvm"

Dependencies

1. fzf brew install fzf

2. fd brew install fd

3. bat brew install bat

Git

Run:

git config --global user.email "you@example.com"
git config --global user.name "Your Name"

Tips

1. Always show hidden files: defaults write com.apple.finder AppleShowAllFiles -boolean true; killall Finder

2. Disable Screen Capture’s …

   • Drop shadow: defaults write com.apple.screencapture disable-shadow -bool true
   • Thumbnail preview: defaults write com.apple.screencapture show-thumbnail -bool false

3. zsh-nvm is managed by zsh (don’t use Brew for nvm!). Once installed: nvm upgrade, nvm revert, nvm install --lts (latest “Long-Term Support” release), nvm uninstall <version>

4. Reload shell config: this repo defines a ZLE hook so entering . runs source ~/.zshrc (stock zsh uses . to source a file, for example . ~/.zshrc)