pal-e-docs

tmux-custom

tmux-custom forgejo

Repository Board

Notes

Project Page 1
  • tmux-custom project-tmux-custom

    Vision

    Personal tmux configuration as a living knowledge repo. Not just dotfiles -- documented workflows, philosophy, and customizations that make tmux a powerful workspace manager. Symlinked to ~/.tmux.conf for instant deployment across machines.

    User Stories

    Key Role Want Success Metric
    session-management tmux user Organize and navigate sessions efficiently Can reorder sessions, switch by MRU, persist across reboots

    Architecture

    arch-tmux-config -- single-file config with TPM plugin management and three-phase load order.

    Board

    board-tmux-custom

    Status

    Core config stable. docs/ directory established with session management, plugin, and config reference docs. Next: session reorder feature (#9).

    Milestones

    None yet.

    Repos

    Repo Platform Role Status
    ldraney/tmux-custom Forgejo Primary config + docs Active
Doc 1
  • Architecture: tmux-config arch-tmux-config

    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:

    1. Core settings -- mouse, status bar, vi mode, clipboard, pane behavior
    2. TPM plugins -- run '~/.tmux/plugins/tpm/tpm' initializes all plugins
    3. 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.

Board 1