Prereqs:
- Clone this repo to
~/Developer/dotfilesor setDOTFILES_DIR=/path/to/dotfiles. - Install GNU Stow. The install script uses
stow --dotfilesto symlink config into$HOME.
ZSH:
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
Install dotfiles:
./bin/dot-bin/install-dotfiles
Notes:
- The script removes
~/.zshrcso Stow can replace the oh-my-zsh generated file with the repo-managed symlink. - In Docker/dev containers the script skips GUI-only config: Alacritty, Ghostty, skhd, Herdr, and Triage.
- Stowed config includes shell, git/delta, Neovim, tmux/tmuxinator, Herdr, Starship, Lazygit, Claude Code settings/scripts, and
~/bin. - Agent config lives in two separate repos, which the script clones into
~/Developerwhen missing (override withAGENTS_REPO_URL/PI_CONFIG_REPO_URL) and stows without--dotfiles:- drosam/agents: shared skills and sub-agents, linked into
~/.agents. The script also links them into~/.claude/skillsand~/.claude/agents. - drosam/pi-config: Pi config, linked into
~/.pi/agent. Its README covers the work-artifact layout, spec/plan links, and cross-session selection.
- drosam/agents: shared skills and sub-agents, linked into
brew install --cask font-meslo-lg-nerd-font
brew install curl git git-delta gnu-sed alacritty neovim tmux tmuxinator jesseduffield/lazygit/lazygit ripgrep koekeishiya/formulae/skhd stow starship ghostty fzf gnupg pass htop openssl
mkdir -p ~/.tmux/plugins/catppuccin
git clone -b v2.1.3 https://github.com/catppuccin/tmux.git ~/.tmux/plugins/catppuccin/tmux
skhd --start-service
./bin/dot-bin/install-dotfiles
git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm && ~/.tmux/plugins/tpm/bin/install_plugins
Herdr (agent terminal multiplexer):
brew install herdr
./bin/dot-bin/install-dotfiles
herdr integration install pi
herdr integration status
herdr plugin link ~/.config/herdr-plugins/lastfocus
Notes:
- Run
install-dotfilesbefore the firstherdrlaunch. Herdr onboarding writes~/.config/herdr/config.toml, which blocks the stow link; remove that file and rerun the script if it already exists. - The Pi integration writes
herdr-agent-state.tsinto~/Developer/pi-config/extensions/through the stowed symlink. - Apply config edits to a running server with
herdr server reload-config. lastfocusplugin (herdr/dot-config/herdr-plugins/lastfocus/): tmux-style toggles.prefix+tabjumps to the last tab in the current workspace,prefix+shift+tabto the last workspace. These keys replace the defaultcycle_pane_next/cycle_pane_previous. Event hooks ontab.focused/workspace.focusedrecord current/previous ids in~/.local/state/herdr/plugins/lastfocus/; requiresjq. Debug withherdr plugin log list --plugin lastfocus.- Local plugins live in
~/.config/herdr-plugins/, not~/.config/herdr/plugins/. Herdr treats~/.config/herdr/plugins/<id>as a legacy config location and copies its contents into~/.config/herdr/plugins/config/<id>on link.
Triage (link router):
brew install --cask jmanuelrosa/tap/triage
./bin/dot-bin/install-dotfiles
Notes:
- Config:
triage/dot-config/triage/config.yaml, linked to~/.config/triage/config.yaml. Triage reloads it on save. - Set Triage as default browser from its menu bar icon. Unmatched URLs open in its fallback browser.
Booqable worktrees:
new-booqable-worktree my-task
# Omit the name to prompt. Prints the checkout path; reuses existing worktrees.
# Create/setup the checkout, then open it in Herdr:
worktree=$(new-booqable-worktree my-task) &&
herdr worktree open --cwd "$HOME/Developer/booqable" --path "$worktree" --focusThe tmux booqable-worktree action uses the same helper, then creates its usual windows.
In Herdr, prefix+shift+b opens a popup that runs new-booqable-herdr-worktree: it prompts for the name, creates the worktree with the helper, opens it from the booqable bare-root workspace (Herdr rejects linked worktrees as the source) and builds the develop layout (server, code with nvim, π with Pi as <name>-pi). If the worktree is already open, it focuses that workspace.