Add README documenting dotfiles setup and per-file summaries

Nightshift-Task: docs-backfill
Nightshift-Ref: https://github.com/marcus/nightshift

.tmux.conf

@@ -9,12 +9,9 @@ set -s set-clipboard on
 set -g allow-passthrough on
 
 # utf8 / colors
-set -g default-terminal "tmux-256color"
-set -as terminal-overrides ",*:Tc"
-set -as terminal-overrides ',*:Smulx=\E[4::%p1%dm'
-set -as terminal-overrides ',*:Setulc=\E[58::2::%p1%{65536}%/%d::%p1%{256}%/%{255}%&%d::%p1%{255}%&%d%;m'
-set -g extended-keys on
-set -as terminal-features 'xterm*:extkeys'
+set -g default-terminal "screen-256color"
+set -q -g status-utf8 on
+setw -q -g utf8 on
 
 # panes retain path
 bind '"' split-window -v -c "#{pane_current_path}"
@@ -24,16 +21,6 @@ bind % split-window -h -c "#{pane_current_path}"
 bind -n S-Left if-shell "[ #{window_index} -ne $(tmux list-windows -F '##{window_index}' | head -1) ]" "previous-window"
 bind -n S-Right if-shell "[ #{window_index} -ne $(tmux list-windows -F '##{window_index}' | tail -1) ]" "next-window"
 
-# alt+arrow pane switching
-bind -n M-Left select-pane -L
-bind -n M-Right select-pane -R
-bind -n M-Up select-pane -U
-bind -n M-Down select-pane -D
-
-# alt+[ / alt+] pane switching (prev/next)
-bind -n M-[ select-pane -t :.-
-bind -n M-] select-pane -t :.+
-
 # swap windows left/right with PgUp/PgDn (no wrap)
 bind-key -n PgUp if-shell "[ #{window_index} -ne $(tmux list-windows -F '##{window_index}' | head -1) ]" "swap-window -t -1\; select-window -t -1"
 bind-key -n PgDn if-shell "[ #{window_index} -ne $(tmux list-windows -F '##{window_index}' | tail -1) ]" "swap-window -t +1\; select-window -t +1"
@@ -43,7 +30,6 @@ set -s escape-time 10
 set -g base-index 1
 setw -g pane-base-index 1
 set -g renumber-windows on
-set -g detach-on-destroy off
 
 # Auto-rename windows: directory/process
 set -g automatic-rename on
@@ -52,24 +38,21 @@ set -g automatic-rename-format '#{pane_current_command}@#{b:pane_current_path}#{
 # Rename window (prefix + R)
 bind R command-prompt -I "#{window_name}" "rename-window '%%'"
 
-# Move window to session (prefix + M), creates session if needed
-bind M run-shell 'tmux display-popup -E "tmux-move-to-session #{window_id}"'
-
 # Fuzzy window switcher (prefix + f)
-bind f display-popup -h 80% -E "tmux list-windows -F '#{window_index}: #{window_name}' | fzf --reverse --height=100% | cut -d: -f1 | xargs tmux select-window -t"
+bind f display-popup -E "tmux list-windows -F '#{window_index}: #{window_name}' | fzf --reverse | cut -d: -f1 | xargs tmux select-window -t"
 
 # status bar
-set -g status-style "bg=#262626,fg=#a8a8a8"
-set -g status-left "#[fg=#080808,bg=#00af00,bold]#S#[fg=#00af00,bg=#262626,nobold]"
+set -g status-style "bg=colour235,fg=colour248"
+set -g status-left "#[fg=colour232,bg=colour34,bold]#S#[fg=colour34,bg=colour235,nobold]"
 set -g status-left-length 30
 set -g status-right ""
 set -g status-right-length 40
 
 # window tabs
-setw -g window-status-format "#{?#{m:*[13579],#{window_index}},#[fg=#262626]#[bg=#282828]#[fg=#848484] #I #W #[fg=#282828]#[bg=#262626],#[fg=#262626]#[bg=#1e1e1e]#[fg=#747474] #I #W #[fg=#1e1e1e]#[bg=#262626]}"
-setw -g window-status-current-format "#[fg=#262626,bg=#00af00]#[fg=#080808,bg=#00af00,bold] #I #W #[fg=#00af00,bg=#262626]"
+setw -g window-status-format "#{?#{m:*[13579],#{window_index}},#[fg=colour235]#[bg=colour236]#[fg=colour250] #I #W #[fg=colour236]#[bg=colour235],#[fg=colour235]#[bg=colour233]#[fg=colour244] #I #W #[fg=colour233]#[bg=colour235]}"
+setw -g window-status-current-format "#[fg=colour235,bg=colour34]#[fg=colour232,bg=colour34,bold] #I #W #[fg=colour34,bg=colour235]"
 setw -g window-status-separator ""
 
 # pane borders
-set -g pane-border-style "fg=#444444"
-set -g pane-active-border-style "fg=#00af00"
+set -g pane-border-style "fg=colour238"
+set -g pane-active-border-style "fg=colour34"

.vimrc

@@ -24,6 +24,7 @@ set backupdir=~/.vim/backup//
 set nobackup
 set mouse=a             " mouse support
 
+
 noremap <Up> <NOP>
 noremap <Down> <NOP>
 noremap <Left> <NOP>

.zshenv

@@ -1,13 +0,0 @@
-# .zshenv — sourced for every zsh invocation (interactive, non-interactive, scripts).
-# PATH lives here so cron, ssh host-command, and GUI-launched processes see it.
-
-typeset -U path
-path=(
-  /projects/bin
-  $HOME/.local/bin
-  $HOME/.cargo/bin
-  /usr/local/go/bin
-  $HOME/go/bin
-  /opt/homebrew/bin
-  $path
-)

.zshrc

@@ -36,10 +36,9 @@ zmodload zsh/stat
 
 # plugin manager
 ZINIT_HOME="${XDG_DATA_HOME:-${HOME}}/.zinit.git"
-[ ! -d "$ZINIT_HOME" ] && mkdir -p "$(dirname $ZINIT_HOME)"
-[ ! -d "$ZINIT_HOME/.git" ] && git clone https://github.com/zdharma-continuum/zinit.git "$ZINIT_HOME"
+[ ! -d $ZINIT_HOME ] && mkdir -p "$(dirname $ZINIT_HOME)"
+[ ! -d $ZINIT_HOME/.git ] && git clone https://github.com/zdharma-continuum/zinit.git "$ZINIT_HOME"
 source "${ZINIT_HOME}/zinit.zsh"
-functions[@zinit-scheduler]="setopt localoptions; set +u; ${functions[@zinit-scheduler]}"
 
 zinit light zsh-users/zsh-autosuggestions
 zinit light zsh-users/zsh-syntax-highlighting
@@ -110,7 +109,17 @@ zinit light starship/starship
   git --git-dir=$HOME/.dotgit/ --work-tree=$HOME pull --ff-only -q 2>/dev/null
 } &!
 
-# paths live in ~/.zshenv so non-interactive shells (cron, ssh cmd, GUI) see them
+# paths
+typeset -U path
+path=(
+  /projects/bin
+  $HOME/.local/bin
+  $HOME/.cargo/bin
+  /usr/local/go/bin
+  $HOME/go/bin
+  /opt/homebrew/bin
+  $path
+)
 
 # fzf (if available)
 if (( $+commands[fzf] )); then
@@ -140,17 +149,16 @@ fi
 alias .g='git --git-dir=$HOME/.dotgit/ --work-tree=$HOME'
 
 # aliases: tmux
-alias t="tmux new-session -A -s auto"
-alias tmuxr="tmux new-session -A -s auto"       # attach-or-create "auto"
-alias tmuxn="tmux new-session -A -s auto \; new-window" # same + new window
-alias tmuxa="tmux new-session -A -s"            # attach-or-create named
+alias tmuxr="tmux new-session -A -s auto"
+alias tmuxn="tmux new-session -A -s auto \; new-window"
+alias tmuxa="tmux new-session -A -s"
 
 # yazi wrapper (cd to dir on exit)
 function y() {
   local tmp="$(mktemp -t "yazi-cwd.XXXXXX")" cwd
   command yazi "$@" --cwd-file="$tmp"
   IFS= read -r -d '' cwd < "$tmp"
-  [[ "$cwd" != "$PWD" ]] && [[ -d "$cwd" ]] && builtin cd -- "$cwd"
+  [ "$cwd" != "$PWD" ] && [ -d "$cwd" ] && builtin cd -- "$cwd"
   rm -f -- "$tmp"
 }
 
@@ -171,7 +179,7 @@ function clip {
 function mkcd {
   : "${1:?where?}"
   [[ -e $1 ]] && { echo "file exists"; return 1 }
-  mkdir -p "$1" && cd "$1"
+  mkdir -p $1 && cd $1
 }
 
 function cdtmp {
@@ -188,13 +196,9 @@ alias dcu='docker compose up --force-recreate --detach'
 alias dcd='docker compose down --remove-orphans'
 alias dcl='docker compose logs -f'
 
-# aliases: rsync with sane defaults
-alias rsync2='rsync --info=PROGRESS2 --progress --recursive --compress --human-readable --update --times --no-whole-file --itemize-changes --stats --verbose --links --no-perms --chmod=ugo=rwX'
-
 # aliases: misc
 alias c="claude"
 alias ,cd="IS_SANDBOX=1 claude --dangerously-skip-permissions"
-alias wm="workmux"
 alias zshreload="exec zsh"
 alias -g LATEST='*(om[1])'            # glob: most recently modified
 alias FUNCTION_PRELUDE="setopt LOCAL_OPTIONS PIPE_FAIL XTRACE ERR_RETURN"

README.md

@@ -0,0 +1,92 @@
+# dotfiles
+
+Personal dotfiles managed as a bare Git repository. The repo lives at `~/.dotgit/` with the work tree set to `$HOME`, so tracked files sit at their real paths without symlinks.
+
+## Bootstrap
+
+```bash
+# Clone bare repo
+git clone --bare https://gitea.abra.me/svxf/dotfiles.git "$HOME/.dotgit"
+
+# Checkout files into $HOME
+git --git-dir="$HOME/.dotgit/" --work-tree="$HOME" checkout
+
+# Hide untracked files from status noise
+git --git-dir="$HOME/.dotgit/" --work-tree="$HOME" config status.showUntrackedFiles no
+```
+
+After checkout, restart your shell. Zinit and Starship will self-install on first launch.
+
+## Usage
+
+The `.g` alias wraps `git --git-dir=$HOME/.dotgit/ --work-tree=$HOME`, so everyday operations look like:
+
+```bash
+.g status
+.g add ~/.vimrc
+.g commit -m "update vimrc"
+.g push
+```
+
+A background job in `.zshrc` auto-pulls once per day (`~/.cache/.dotfiles-pull` marker).
+
+## File summaries
+
+### .zshrc
+
+Shell configuration and the main entry point.
+
+- **Plugin manager**: Zinit (auto-installed from `zdharma-continuum/zinit`). Plugins: `zsh-autosuggestions`, `zsh-syntax-highlighting`, `zsh-completions`, `zsh-history-substring-search`.
+- **History**: 100k entries, shared across sessions, deduped, extended format.
+- **Completions**: Case-insensitive matching, menu selection.
+- **Keybindings**: Emacs mode. Ctrl+Q push-line, Alt+E / Ctrl+X,E edit-command-line, Up/Down prefix search.
+- **Prompt**: Starship (installed via Zinit from GitHub releases).
+- **fzf integration**: Keybindings and completion sourced when available; `--height 40% --reverse` default opts.
+- **PATH**: `/projects/bin`, `~/.local/bin`, `~/.cargo/bin`, `/usr/local/go/bin`, `~/go/bin`, `/opt/homebrew/bin`.
+- **Aliases**:
+  - `.g` — bare-repo git wrapper
+  - `tmuxr` / `tmuxn` / `tmuxa` — tmux attach-or-create helpers
+  - `,dcdu` / `,dcdd` / `,dcdl` — docker-compose dev-profile shortcuts
+  - `dcu` / `dcd` / `dcl` — generic docker-compose shortcuts
+  - `c` / `,cd` — Claude CLI / Claude with sandbox skip
+  - `LATEST` — global alias expanding to most-recently-modified file
+- **Functions**:
+  - `y` — yazi file manager wrapper that `cd`s to the selected directory on exit
+  - `pj` — fuzzy project switcher (searches `/projects` and `~/projects` via fzf)
+  - `clip` — pipe stdin to system clipboard via OSC 52 escape sequence
+  - `mkcd` — mkdir + cd in one step
+  - `cdtmp` — create and cd into a timestamped temp directory under `~/tmp/`
+- **Extras**: `~/.zshrc-extra` sourced at end for machine-local overrides (not tracked).
+
+### .tmux.conf
+
+- **Mouse** enabled, clipboard passthrough on.
+- **Splits** preserve current path.
+- **Navigation**: Shift+Arrow switches windows (no wrap), Alt+Arrow switches panes, PgUp/PgDn swaps window order.
+- **Window naming**: Auto-rename to `command@dir`.
+- **Fuzzy switcher**: `prefix + f` opens fzf popup to pick a window.
+- **Status bar**: Dark theme (colour235 bg), green session indicator, powerline-style window tabs with alternating shading, no right-side status.
+- **Pane borders**: Green active, grey inactive.
+- **Base index**: 1 (not 0).
+
+### .vimrc
+
+- `jk` mapped to Escape, Space as leader.
+- 4-space soft tabs, syntax on, cursor line highlighted.
+- Persistent undo (`~/.vim/undo/`), swap and backup dirs under `~/.vim/`.
+- Smart case search, incremental + highlighted.
+- Arrow keys disabled in normal mode (forces hjkl).
+- Mouse support enabled, 8-line scroll margin.
+
+### .starship.toml
+
+Two-line prompt:
+
+- **Line 1** (left → right): Docker container indicator (if inside), docker-compose service summary (running/stopped counts), git branch + status, fill, directory.
+- **Line 2**: `➤` character (green on success, red on error).
+- **Right prompt**: Command duration (>5s), `user@host`, time.
+- Docker-compose status uses `docker compose ps --format json | jq` to show `▲N/▼N` counts.
+
+### .gitignore_global
+
+Ignores: `*~`, `.DS_Store`, `.idea`, `.ipynb_checkpoints`, `__pycache__`.