Dotfiles banner
paulalden paulalden

Dotfiles

Development community

Description

My MacOS focused development environment dotfiles.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

dotfiles

My MacOS focused development environment dotfiles.

Installation

Fresh macOS Setup

# 1. Clone the repo
git clone https://github.com/YOUR_USER/dotfiles.git ~/Personal/repos/dotfiles
cd ~/Personal/repos/dotfiles

# 2. Run the install script — it does everything else
./install

`./install` handles the rest:

  • Installs Homebrew and dotbot if they're missing.
  • Runs monitoring-software detection before touching anything.
  • Asks about window management — yabai, skhd, sketchybar, and borders need special macOS permissions and partial SIP disabling, so they're an explicit y/N prompt (with their own Brewfile and dotbot config).
  • Symlinks everything via dotbot, installs the Brewfile packages, clones TPM and installs the tmux plugins, and applies macOS defaults.

Post-Install

  • Open a new terminal to load the ZSH configuration.
  • Neovim plugins auto-install on the first nvim launch.

Requirements

  • macOS (Apple Silicon, paths assume /opt/homebrew/)
  • Xcode Command Line Tools (xcode-select --install)
  • SSH key at ~/.ssh/id_rsa (optional, for git/GitHub)
  • ~/secrets.sh for private environment variables (optional)

Applications

  • Nord Color Scheme
  • Homebrew
  • Yabai WM & SKHD
  • Sketchybar
  • Kitty
  • Tmux
  • Neovim
    • Ruby development focused
    • LSP
    • Treesitter
    • Snacks
    • Git
  • Ranger
  • Bat
  • ZSH
  • FZF
  • Pure ZSH prompt
  • LazyGit

Screenshots

![Desktop](https://github.com/user-attachments/assets/998e7a07-f164-481c-9533-9565f5396203) ![Neovim](https://github.com/user-attachments/assets/a7d33132-b177-4d1d-aeff-708ebf29c481) ![Tmux](https://github.com/user-attachments/assets/f547c5f2-7582-4d98-8db1-11e7ac666b34) ![Lazygit](https://github.com/user-attachments/assets/cc4fbde6-da74-4a3a-b668-edab709f1abb) ![Tmux Sessions](https://github.com/user-attachments/assets/97508672-318c-43bc-8088-a1cf721093ad) ![Tmux Search](https://github.com/user-attachments/assets/8adc86ee-50fb-41fe-b7cd-74a