🔧 dotfiles zsh oh-my-zsh

📂 installation

system

1. Homebrew
2. Git brew install git
3. Oh My Zsh (required) sh -c "$(curl -fsSL https://githubusercontent.com)"
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 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 in your home dotfiles folder. 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_CUSTOM/plugins/zsh-autosuggestions"
2. zsh-nvm git clone https://github.com "$ZSH_CUSTOM/plugins/zsh-nvm"

customization

the configuration looks for an optional machine-specific file in your home directory

• ~/scripts.zsh for local aliases, api keys, or private functions

dependencies

brew install fzf fd bat tree zoxide

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 drop shadow defaults write com.apple.screencapture disable-shadow -bool true
3. disable screen capture thumbnail preview defaults write com.apple.screencapture show-thumbnail -bool false
4. manage nvm via zsh plugin run nvm upgrade nvm revert nvm install --lts or nvm uninstall version
5. jump to directories with zoxide instead of cd type z and a partial name like z canvas
6. search files with ctrl t and search directories with alt c to see dynamic sidebar previews
7. clear corrupt environments quickly run node-vacuum to drop node_modules and wipe dependency caches
8. reload shell config rapidly enter dot instead of typing the full source command
9. store generated app cli scripts point third-party tool locations like jetbrains to bin directory
10. keep personal scripts separate drop your custom hand-written tools into scripts directory