CR: dots-quantum tmux Package — Risk & Communications

Risk Assessment

Risk Severity Mitigation

Tmux symlink collision

HIGH

Choose single source before stowing

Shell config overwrite

MEDIUM

Back up ~/.zshrc first

Host-specific loss

LOW

Deploy hosts/ only to intended machines

Safe Migration Path

Phase 1: Pre-Migration

# Remove optimus symlinks that will be replaced
rm ~/.gitconfig ~/.zshrc ~/.zshenv ~/.zprofile

# For tmux (choose ONE):
# Option A: Keep tmux-config repo (skip quantum tmux)
# Option B: Migrate to quantum:
rm ~/.tmux.conf ~/.config/tmux ~/.config/tmuxinator

Phase 2: Deploy Quantum Packages

# Reload shell for new aliases
source ~/.zshrc

# List available packages
dq-list

# Deploy all safe packages (test with -n first)
dq-stow -n bash zsh git vim bin
dq-stow bash zsh git vim bin

# Deploy tmux (if migrating from tmux-config)
dq-stow tmux

# Install TPM plugins
git clone https://github.com/tmux-plugins/tpm ~/.config/tmux/plugins/tpm
# Then in tmux: prefix + I

Phase 3: Verify

# Check symlinks
ls -la ~/.[a-z]* | grep -E "->|^l"
ls -la ~/.config/ | grep quantum

Related Documents