Skip to content

README.md

Latest commit

 

History

History
40 lines (31 loc) · 995 Bytes

README.md

File metadata and controls

40 lines (31 loc) · 995 Bytes

dotfiles

macOS dotfiles for shell setup, tool installs, and symlinked config.

Bootstrap

cd ~/Projects
git clone --recursive https://github.com/rtimmons/dotfiles.git
cd dotfiles
just update

Key Commands

just update      # pull, brew update/upgrade, link symlinks, run installs, shellcheck
just install     # run install.sh scripts only
just link        # refresh symlinks only
just shellcheck  # lint managed shell scripts

Layout

  • Each top-level directory owns one tool or concern.
  • install.sh scripts must stay silent on success.
  • *.symlink files are linked into ~/.*.
  • *.0zshrc files load before *.zshrc files.
  • ~/.prerc loads before repo zsh config and ~/.localrc loads after it.

Notes

  • Test changes with just when the change is safe to run end to end.
  • Use command -v <cmd> >/dev/null 2>&1 for command existence checks.
  • Keep tool-specific PATH changes local to the tool that needs them.