GeezerVison

Summary

This is a replacement recut for #1025. It keeps the parity work in three reviewable commits:

• importer parity for tmuxinator/teamocil conversion
• runtime/load parity for lifecycle hooks, here mode, pane titles, synchronization, templating, and config-management commands
• docs, examples, changelog, and documented example tests

Closes #1031.

Review Fixes Folded In

• Avoids respawning the active pane running tmuxp load --here.
• Runs shell_command_after before synchronized panes are enabled.
• Validates tmuxp delete targets before unlinking files.
• Lets lifecycle hooks run without the previous undocumented timeout.
• Normalizes --here outside tmux before existing-session handling.
• Expands workspace-level config fallback paths before Server creation, including ./tmux.conf relative to the workspace file and ~/tmux.conf via HOME.

Parity Check

The final tree matches the original parity branch except for the intentional workspace config path-expansion fix and its regression coverage:

• src/tmuxp/cli/load.py
• tests/cli/test_load.py

Verification

Run before each commit and again at branch tip:

$ unset NO_COLOR; rm -rf docs/_build; uv run ruff check . --fix --show-fixes; uv run ruff format .; uv run mypy .; uv run py.test --reruns 0 -vvv; just build-docs;

Final branch-tip results:

• uv run ruff check . --fix --show-fixes: all checks passed
• uv run ruff format .: 144 files left unchanged
• uv run mypy .: success, no issues in 144 source files
• uv run py.test --reruns 0 -vvv: 1038 passed, 2 skipped
• just build-docs: build succeeded with 76 existing warnings

NO_COLOR was unset for the gates because this local shell exports NO_COLOR=1, while existing color tests assert ANSI output in forced-color cases.