This document provides production-ready specifications for implementing a declarative, Nix flake-based tmux configuration for the Kalilix project. The implementation eliminates imperative plugin management (TPM), achieves hermetic reproducibility through home-manager, and delivers a 90% solution for modern terminal-based development workflows targeting macOS, Linux, and WSL environments.
Core recommendation: Use home-manager's programs.tmux module with tmuxp for session management, vim-tmux-navigator for neovim integration, and Catppuccin Macchiato theme with samoshkin's F12 nested session pattern for remote work. This combination provides battle-tested reliability, excellent Nix integration, and minimal cognitive overhead.
Why this matters: Developers waste 5-10 minutes daily on tmux configuration inconsistencies, SSH clipboard issues, and context switching between local/remote sessions. A