Modular zsh dotfiles managed with stow.
| Package | Contents |
|---|---|
zsh |
modular .zshrc + .zsh/ config files |
starship |
starship prompt config |
btop |
btop config + catppuccin theme |
claude |
Claude Code agents, skills, rules |
mc |
midnight commander + catppuccin skin |
Plugin manager: antidote (static bundle — zero startup cost) Syntax highlighting: zsh-patina
git clone https://github.com/wiseelf/dotfiles/public ~/dotfiles/public
git clone <private-repo-url> ~/dotfiles/private # optional
cd ~/dotfiles/public
./install.shinstall.sh is platform-aware: installs zsh on Linux, runs brew bundle on macOS. It expects the private repo at ../private relative to itself (i.e. ~/dotfiles/private). Override with PRIVATE_DIR=/path/to/private ./install.sh.
Machine-specific and sensitive config lives in a separate private repo. The installer stows shared private packages automatically. Machine-specific packages must be stowed manually from the private repo after install.
The installer auto-detects ../private alongside the public repo. Set PRIVATE_DIR to use a different path. The public .zshrc automatically sources ~/.zsh/private/*.zsh if present.
Stow individual packages selectively:
stow --no-folding --target=$HOME zsh # shell only (e.g. remote servers)
stow --no-folding --target=$HOME zsh btop # shell + system monitorsettings.json records enabled plugins and extra marketplaces, but that's
bookkeeping only — declaring enabledPlugins/extraKnownMarketplaces does
not trigger a clone or install. Plugin content lives in ~/.claude/plugins/
(cache + marketplace clones), which isn't tracked by this repo and isn't
installed by install.sh (no claude CLI bootstrap there yet). On a fresh
machine, run manually after install.sh:
claude plugin marketplace add mattpocock/skills
claude plugin marketplace add antonbabenko/agent-plugins
claude plugin install code-simplifier@claude-plugins-official
claude plugin install security-guidance@claude-plugins-official
claude plugin install superpowers@claude-plugins-official
claude plugin install mattpocock-skills@mattpocockMarketplaces track their default branch — the CLI has no version/ref pin
(marketplace add, install, update all lack that flag).