Quantum tmux Configuration Design

Complete the book before building this config. Premature optimization leads to cargo-culted settings.

Design Principles

Based on book learnings, my tmux config will follow these principles:

  1. _

  2. _

  3. _

  4. _

Structure Decision

After reading Chapter 2 and 3, I choose:

  • Single file (tmux.conf) - simple, portable

  • Modular files with source-file - organized by concern

  • tmuxinator-only - project-specific configs

Rationale:

Configuration Sections

Core Settings

# Core settings decided from book

# Prefix key
set -g prefix ___

# Base index (0 or 1)
set -g base-index ___

# Mouse support
set -g mouse ___

# History limit
set -g history-limit ___

# Escape time (for vim)
set -sg escape-time ___

Key Bindings

# Bindings I want to keep/add

# Pane splitting


# Pane navigation


# Window navigation


# Config reload


# Custom bindings

Appearance

# Visual settings

# True color support


# Status line


# Pane borders


# Colors (Catppuccin Mocha to match Hyprland)

Copy Mode

# Copy/paste settings

# Vi mode
set-window-option -g mode-keys vi

# Wayland clipboard integration


# Selection bindings

Plugins

Plugins I’ll use (after evaluating in book):

Plugin Purpose Keep?

tpm

Plugin manager

[ ]

tmux-resurrect

Session persistence

[ ]

tmux-continuum

Auto-save sessions

[ ]

(others)

[ ]

Migration Plan

From tmux-config to quantum

  1. [ ] Complete the book

  2. [ ] Build quantum config from scratch

  3. [ ] Test for 1 week

  4. [ ] Archive tmux-config to ~/atelier/_archive/2026/

  5. [ ] Update dots-quantum stow

Rollback Plan

If quantum config has issues:

# Quick rollback to tmux-config
rm ~/.config/tmux
ln -s ~/atelier/_projects/personal/tmux-config ~/.config/tmux

Comparison: Before and After

Aspect Old (tmux-config) New (quantum)

Lines of config

~45 (modular)

Prefix

Ctrl+b (default?)

Plugins

Theme

aethelred

tmuxinator integration

07_TMUXINATOR/

Implementation

Once ready, create the config:

# Create quantum tmux config
mkdir -p ~/atelier/_projects/personal/dots-quantum/tmux/.config/tmux

# Write config
nvim ~/atelier/_projects/personal/dots-quantum/tmux/.config/tmux/tmux.conf

# Test without stow first
tmux source-file ~/atelier/_projects/personal/dots-quantum/tmux/.config/tmux/tmux.conf

# When ready, stow it
cd ~/atelier/_projects/personal/dots-quantum
stow -t ~ tmux

Final Notes

Space for final thoughts after completing the book and building the config.

Sign-Off

  • Book completed

  • Config designed with intention

  • Config tested

  • tmux-config archived

  • quantum tmux is primary

Completion date: _