docs: add a real tmux config example for global defaults and keybindings #32

New issue

Closed

opened 2026-04-25 21:00:11 +00:00 by barrettruth · 0 comments

barrettruth commented

2026-04-25 21:00:11 +00:00

Now that @mosaic-algorithm supports a global default with window-local overrides and off, the docs should show a real tmux setup instead of only isolated snippets.

What users actually want is:

set master-stack once as the default for every window
keep per-window overrides for cases like grid or monocle
disable mosaic on one window without turning it off everywhere
add their own keybindings, since mosaic does not install any

Should cover

global default:
- set-option -gwq @mosaic-algorithm master-stack
optional related defaults such as orientation and mfact
per-window override:
- set-option -wq @mosaic-algorithm grid
per-window disable:
- set-option -wq @mosaic-algorithm off
clearing a local override to fall back to global again:
- set-option -wqu @mosaic-algorithm
a small but realistic @mosaic-exec keybinding block
where this should live: README vs INSTALLATION vs layout docs

This should read like an actual tmux config recipe, not just option reference.

Now that `@mosaic-algorithm` supports a global default with window-local overrides and `off`, the docs should show a real tmux setup instead of only isolated snippets. What users actually want is: - set `master-stack` once as the default for every window - keep per-window overrides for cases like `grid` or `monocle` - disable mosaic on one window without turning it off everywhere - add their own keybindings, since mosaic does not install any ## Should cover - global default: - `set-option -gwq @mosaic-algorithm master-stack` - optional related defaults such as orientation and mfact - per-window override: - `set-option -wq @mosaic-algorithm grid` - per-window disable: - `set-option -wq @mosaic-algorithm off` - clearing a local override to fall back to global again: - `set-option -wqu @mosaic-algorithm` - a small but realistic `@mosaic-exec` keybinding block - where this should live: README vs INSTALLATION vs layout docs This should read like an actual tmux config recipe, not just option reference.