configuring-tmuxlisted

# Configuring tmux ## Step 0: Choose a Framework Ask the user which framework they want **before** touching any config. ### Option 1: oh-my-tmux ```bash cd ~ && git clone https://github.com/gpakosz/.tmux.git ln -sf .tmux/.tmux.conf .tmux.conf cp .tmux/.tmux.conf.local .tmux.conf.local ``` - Theming via `tmux_conf_theme_*` variables in `~/.tmux.conf.local` — never edit `~/.tmux.conf` - **Gotcha:** its theming layer owns bar 0 and overrides raw `set -g status-right` — use `status-format[]` for extra bars ### Option 2: Catppuccin (TPM-based, no clone needed) ```bash set -g @plugin 'catppuccin/tmux#v2.1.3' set -g @catppuccin_flavor 'mocha' set -g @catppuccin_status_modules_right "application session date_time" ``` - Module list controls bar 0 — add custom `#()` calls via `status-right-append` - Extra bars use `status-format[]` directly ### Option 3: tmux-powerline ```bash git clone https://github.com/erikw/tmux-powerline.git ~/.config/tmux-powerline set-option -g status-left "#(~/.config/tmux-powerline/powerline.sh left)" set-option -g status-right "#(~/.config/tmux-powerline/powerline.sh right)" ``` - Requires Nerd Font or Powerline-patched font - Segments live in `~/.config/tmux-powerline/segments/` ### Option 4: User-provided framework Ask for: repo URL, install method, where customizations live, how it handles status content. Then apply the patterns below. --- ## Plugin Setup (all frameworks) ```bash # Install TPM git clone https://github.com/tmux-plugins/tpm ~/.conf