Updating config doesn’t create missing windows/panes or re-run start command
Author: akshay-naCreated Aug 19, 2025Updated Aug 19, 2025
Description
I’ve been experimenting with tmuxinator and ran into an issue when updating an existing project config.
If I modify a config to add new windows or panes, or if I’ve closed an existing pane and then re-run tmuxinator start <project>, tmuxinator just attaches me to the existing session. It doesn’t create the missing windows/panes, nor does it re-run the commands defined in the config.
Steps to Reproduce
- Create a simple config, e.g. ~/.tmuxinator/sample.yml:
name: sample
root: ~/
windows:
- editor:
layout: main-vertical
panes:
- editor:
- vim
- guardRun tmuxinator start sample. Everything works as expected.Update the config to add new windows/panes or close the guard pane:
name: sample
root: ~/
windows:
- editor:
layout: main-vertical
panes:
- editor:
- vim
- guard
- server: bundle exec rails s
- logs: tail -f log/development.log- Run
tmuxinator start sampleagain.
Expected Behaviour (My Expectation)
- If new windows/panes are added in the config, they should be created when starting the project again.
- If a pane has been closed, it should be recreated and run the command from the config.
- Already running processes in existing panes should remain untouched.
Actual Behaviour
- tmuxinator start sample only attaches to the existing session.
- New windows/panes are not created.
- Closed panes are not recreated.
- Commands from the updated config are not re-run.
Notes
- I do not want to stop and restart the entire project/session, because that kills existing processes (e.g. a running server).
- My use case: I may already be running a Ruby API server in one pane. Later, I want to add a watcher in another pane. I don’t want to stop the running server just to have the watcher created.
Additional Info:
I'm running following versions of the softwares.
- tmux v3.5a
- tmuxinator v3.3.5
- ruby v2.6.10p210
- macOS v15.5 arm64
- zsh v5.9
- HomeBrew v4.6.4
Source: tmuxinator/tmuxinator