Skip to content

Commit cfd6449

Browse files
committed
docs(parity-tmuxinator): Fix fallback order, add missing CLI details
why: Second parity pass found inaccurate fallback chain order and missing CLI commands/flags. what: - Fix pre_window fallback chain: pre_window β†’ pre_tab β†’ rbenv β†’ rvm (was reversed) - Add doctor command and completions to commands table - Add start --append, --no-pre-window, --project-config flags - Add list --active, --newline flags
1 parent 422b151 commit cfd6449

1 file changed

Lines changed: 14 additions & 2 deletions

File tree

β€Žnotes/parity-tmuxinator.mdβ€Ž

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -157,8 +157,20 @@ Outputs the generated shell script without executing it.
157157
| `tmuxinator implode` | Delete ALL configs |
158158
| `tmuxinator stop <project>` | Stop session + run hooks |
159159
| `tmuxinator stop-all` | Stop all managed sessions |
160+
| `tmuxinator doctor` | Check system setup (tmux installed, version) |
161+
| `tmuxinator completions` | Shell completion helper |
160162

161-
**Gap**: tmuxp has `edit` but not `new`, `copy`, `delete`, `implode`, or `stop` commands.
163+
**Gap**: tmuxp has `edit` but not `new`, `copy`, `delete`, `implode`, `stop`, or `doctor` commands.
164+
165+
Additional CLI flags on `start`:
166+
- `--append` β€” append windows to existing session (tmuxp has `--append`)
167+
- `--no-pre-window` β€” skip pre_window commands (tmuxp lacks this)
168+
- `--project-config` / `-p` β€” use specific config file (tmuxp uses positional arg)
169+
- `--suppress-tmux-version-warning` β€” skip tmux version check
170+
171+
Additional flags on `list`:
172+
- `--active` / `-a` β€” filter by active sessions (tmuxp lacks this)
173+
- `--newline` / `-n` β€” one entry per line
162174

163175
### 11. `--no-pre-window` Flag
164176

@@ -170,7 +182,7 @@ tmuxinator start myproject --no-pre-window
170182

171183
Skips `pre_window` commands. Useful for debugging.
172184

173-
Note: tmuxinator's `pre_window` method has a fallback chain (`project.rb:175-188`): `rbenv` β†’ `rvm` β†’ `pre_tab` β†’ `pre_window`. The `--no-pre-window` flag disables all of these, not just `pre_window`.
185+
Note: tmuxinator's `pre_window` method has a fallback chain (`project.rb:175-186`): `pre_window` β†’ `pre_tab` β†’ `rbenv` β†’ `rvm` (highest priority first, using Ruby's `||` operator). The `--no-pre-window` flag disables all of these, not just `pre_window`.
174186

175187
**Gap**: tmuxp has no equivalent flag to skip `shell_command_before`.
176188

0 commit comments

Comments
Β (0)