Shell setup notes

This repo tracks the shell/editor setup under /home/nmuoh/.dotfiles and is organized for Stow.

Package docs

• bash
• tmux
• micro
• nvim
• starship
• fzf
• local-bin
• bash-completions
• git

Root docs

• AGENTS.md
• docs/ — per-tool reference docs

Layout

• Root docs stay at the repo root and are never stowed
• Package docs live beside their package config in <package>/README.md
• Generated/plugin content belongs in bootstrap.sh, not in Stow packages

Bootstrap and stow

Run bootstrap first to clone plugins and generated content, then stow the packages:

./bootstrap.sh --dry-run   # preview
./bootstrap.sh             # apply

If config files already exist in $HOME, use --adopt on the first stow pass:

stow -nv bash micro tmux nvim starship fzf local-bin bash-completions lazygit git
stow -v  bash micro tmux nvim starship fzf local-bin bash-completions lazygit git

To set up the Treemux sidebar (optional):

ENABLE_TREEMUX=1 ./bootstrap.sh