Newer
Older
ops-toolkit / packs / tmuxinator / README.md

tmuxinator -- one-command project workspaces

Why the team uses it: repeatable tmux session layouts defined in YAML. tmuxinator start <project> builds (or reattaches to) the whole workspace -- windows, panes, startup commands -- so every tech gets the same layout for the same job, and nothing is rebuilt by hand after a disconnect.

What this pack installs:

  • install-010-core.sh -- tmuxinator via apt (one package source for
                              the team; no per-user gem environments)
  • install-020-templates.sh -- seeds ~/.config/tmuxinator/ from
                              `templates/` (copy-if-absent: your edited
                              project files are never overwritten)

House rules:

  • Templates in this repo carry NO environment-specific values (no IPs, IDs, hostnames). Fill those in your local copy, or better: have the project YAML discover them at runtime.
  • A template that a whole team runs for a specific project belongs in THAT project's repo; this pack ships generic starting points only.
  • Depends on the tmux pack being installed first (bootstrap order handles this when using --all).