pal-e-docs

Architecture: tmux-config

arch-tmux-config Doc

architecture active
Project

Architecture: tmux-config

Single-file tmux configuration with plugin management.

Components

  • .tmux.conf -- main config, symlinked to ~/.tmux.conf
  • TPM -- plugin manager, installed at ~/.tmux/plugins/tpm
  • docs/ -- usage philosophy and reference documentation

Load Order

Config loads in three phases:
  • Core settings -- mouse, status bar, vi mode, clipboard, pane behavior
  • TPM plugins -- run '~/.tmux/plugins/tpm/tpm' initializes all plugins
  • Post-plugin overrides -- settings that must override plugin defaults (automatic-rename, swap-window, catppuccin format)

Cross-Platform

OS detection via if-shell "uname | grep -q Darwin" branches macOS vs Linux for clipboard and battery commands. No manual per-machine configuration.