cc init. add tmux config. and nvim as submodule.

README.md

@@ -0,0 +1,59 @@
+# dotfiles
+
+Personal config, deployed with [GNU Stow](https://www.gnu.org/software/stow/).
+
+## Layout
+
+```
+.
+├── git/    -> $HOME              (.gitconfig)
+├── nvim/   -> $HOME/.config/     (nvim/)
+├── shell/  -> $HOME              (.zshrc, .userrc, .musicrc)
+└── tmux/   -> $HOME              (.config/tmux/{tmux.conf,tmux.conf.local,oh-my-tmux/})
+```
+
+Each subdirectory mirrors the target tree; `stow` symlinks its contents into
+the right destination.
+
+## Install
+
+```bash
+# prerequisite
+brew install stow
+
+git clone --recurse-submodules https://github.com/publicmatt/dotfiles ~/dotfiles
+cd ~/dotfiles
+make            # init submodules + deploy everything
+make tmux       # or a single package
+```
+
+To remove links: `stow -D <pkg> -t <target>`.
+
+## tmux
+
+Uses [gpakosz/.tmux](https://github.com/gpakosz/.tmux) (oh-my-tmux), vendored
+as a git submodule at `tmux/.config/tmux/oh-my-tmux/`. Customizations live in
+`tmux/.config/tmux/tmux.conf.local`.
+
+Notable features from the local overrides:
+
+- default `C-b` prefix (stock bindings preserved)
+- splits inherit current path; new windows start at `$HOME`
+- vi copy-mode, selections piped to `pbcopy`
+- `prefix m` toggles mouse
+- `F12` toggles prefix off (pass-through for nested tmux / ssh)
+- powerline status bar with uptime, battery, hostname
+
+Update upstream:
+
+```bash
+git submodule update --remote tmux/.config/tmux/oh-my-tmux
+```
+
+Before first `make tmux`, remove the existing `~/.config/tmux/` so stow can
+take over:
+
+```bash
+mv ~/.config/tmux ~/.config/tmux.bak
+make tmux
+```