README.md

Configuration Files

Note

This configuration is specifically optimized to work with my custom keyboard / layout. If you want to use it, you'll likely want to make some changes.

Bootstrap

To setup a new machine run the bootstrap script:

git clone git@github.com:minusfive/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
source ./scripts/bootstrap.zsh

Read the bootstrap script to understand what it does, and the Brewfile to see what apps it installs.

Update

Important

You should grant Wezterm "Application Management" access in System Preferences > Security & Privacy > Application Management so this script is allowed to update all managed applications.

To update the configuration and all installed tools/apps, run the update script:

cd ~/.dotfiles
source ./scripts/update.zsh

Tools

• Neovim - Text Editor / IDE
  • LazyVim - Neovim Plugin and Configuration Manager
  • See the Neovim configuration for the full list of installed plugins and settings.
• Hammerspoon - macOS Automation (app launcher, window / system manager, etc.)
• WezTerm - Terminal Emulator
• Homebrew - macOS Package Manager
  • See the Brewfile and the bootstrap script for the full list of installed tools, apps, themes, plugins, etc.
• GNU Stow - Symlink Manager
• GNU Coreutils - Core Utilities
• Zsh - Shell
• Oh My Zsh - Zsh Configuration Manager
• Powerlevel10k - Zsh Theme
• Yazi - File Manager Terminal UI
• fzf - Fuzzy Finder
• lazygit - Git Terminal UI
• fd - Better find
• ripgrep - Better grep
• bat - Better cat
• zoxide - Better cd
• htop - Better top
• eza - Better ls
• Catppuccin - Color scheme for everything