Dotfiles

I try to maintain here only what I'm currently using. Everything else gets deleted.

Setup

Clone this repo to ~/.dotfiles and use GNU Stow to symlink what you need:

cd ~/.dotfiles
stow editors
stow git
stow herdr

Each top-level folder is a stow package. Running stow <folder> creates symlinks from the folder's contents into ~, mirroring the directory structure. For example, stow editors links:

• editors/.emacs → ~/.emacs
• editors/.config/nvim/init.vim → ~/.config/nvim/init.vim

Run Stow from ~/.dotfiles so it reads this repo's .stowrc, which enables --no-folding automatically for every package. New links point to individual files rather than whole directories, keeping app-generated state out of the repo. Existing directory symlinks are not automatically converted.

Stow will not overwrite existing files. If a target already exists, it will error out. Back up or remove the conflicting file first, then re-run.

Packages

Folder	Contents
editors	Emacs, Neovim, EditorConfig
git	gitconfig, global gitignore
herdr	Herdr config (no session state, logs, or sockets)
ssh	SSH client config
tmux	tmux.conf
tty	Ghostty terminal config

Ghostty over SSH

Ghostty sets TERM=xterm-ghostty. If a remote host does not know that terminfo entry, shell editing can behave strangely (for example, backspace may not delete). Install the local terminfo on the remote host with:

infocmp -x xterm-ghostty | ssh <host> 'tic -x -'

Fallback: set TERM=xterm-256color for that host in ~/.ssh/config.

Unlinked

The unlinked/ folder contains files that are not meant to be stowed. They need to be sourced or referenced manually.

• zshrc.local: Shell config (aliases, history, tools, PATH). Add this to your ~/.zshrc:

  source ~/.dotfiles/unlinked/zshrc.local

• tmuxline_snapshot.conf: Tmux status bar theme generated by tmuxline.vim. Already referenced by .tmux.conf via source-file, so no extra setup needed if you stow tmux.