Title: tmuxinator/teamocil feature parity · Issue #1016 · tmux-python/tmuxp · GitHub
Open Graph Title: tmuxinator/teamocil feature parity · Issue #1016 · tmux-python/tmuxp
X Title: tmuxinator/teamocil feature parity · Issue #1016 · tmux-python/tmuxp
Description: Status (2026-03-15): All libtmux blockers resolved — libtmux#635 is closed. L1, L2, L3 all shipped in libtmux v0.55.0 (2026-03-07). tmuxp pins libtmux~=0.55.0. Phase 1 (import fixes) is complete (7/7 items, 21 tests pass). All remaining ...
Open Graph Description: Status (2026-03-15): All libtmux blockers resolved — libtmux#635 is closed. L1, L2, L3 all shipped in libtmux v0.55.0 (2026-03-07). tmuxp pins libtmux~=0.55.0. Phase 1 (import fixes) is complete (7...
X Description: Status (2026-03-15): All libtmux blockers resolved — libtmux#635 is closed. L1, L2, L3 all shipped in libtmux v0.55.0 (2026-03-07). tmuxp pins libtmux~=0.55.0. Phase 1 (import fixes) is complete (7...
Opengraph URL: https://github.com/tmux-python/tmuxp/issues/1016
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"tmuxinator/teamocil feature parity","articleBody":"> **Status (2026-03-15):** All libtmux blockers resolved — [libtmux#635](https://github.com/tmux-python/libtmux/issues/635) is **closed**. L1, L2, L3 all shipped in libtmux v0.55.0 (2026-03-07). tmuxp pins `libtmux~=0.55.0`. Phase 1 (import fixes) is **complete** (7/7 items, 21 tests pass). All remaining work is purely tmuxp-side — zero libtmux dependencies remain.\n\n## Summary\n\nTracking issue for reaching feature parity with tmuxinator (3.3.7) and teamocil (1.4.2). Based on a comprehensive source-level analysis of both projects, their importers, and the tmuxp builder/loader/CLI.\n\nTracking issue for libtmux-side API additions: https://github.com/tmux-python/libtmux/issues/635\n\n---\n\n## Phase 1: Import Fixes (No Builder/libtmux Changes) — **COMPLETE**\n\nAll 7 items done, 21 tests pass.\n\n- [x] **I1.** tmuxinator `pre` / `pre_window` mapping bugs — fixed `pre` → `before_script`, `pre_window` → `shell_command_before` (`1967487a`)\n- [x] **I2.** tmuxinator `cli_args` / `tmux_options` fragile parsing — use `shlex.split()` for flag-aware parsing (`e8016019`)\n- [x] **I3.** teamocil redundant filter loops — replace with direct assignment (`f61343a3`)\n- [x] **I4.** teamocil v1.x format support — string panes, `commands` key (`f61343a3`)\n- [x] **I5.** tmuxinator missing keys — `rvm`, `pre_tab`, `startup_window`, `startup_pane`, `synchronize` (`5cb75946`)\n- [x] **I6.** teamocil missing keys — `focus`, `options`, `height` handling (`466fc9b2`)\n- [x] **I7.** Importer TODOs — logging for unsupported/dropped keys, remove stale TODOs (`74656db5`)\n\n---\n\n## Phase 2: Builder Additions (tmuxp Only)\n\n### T1. No `synchronize` Config Key\n\n- [x] **Desugared** — importer maps `synchronize: true/before` → `options: {synchronize-panes: on}` and `synchronize: after` → `options_after: {synchronize-panes: on}`. Builder already handles both `options` and `options_after`. No builder change needed.\n\n### T3. No `shell_command_after` Config Key\n\n- [ ] Teamocil importer produces `shell_command_after` (from `filters.after`), but builder never reads it.\n- **Implementation:** Read `window_config.get(\"shell_command_after\", [])` in `config_after_window()` and send to panes. ~5 lines.\n\n### T2. No Pane Title Config Key — **NOW UNBLOCKED**\n\n- [ ] **Previously blocked on L1** — now resolved. `Pane.set_title(title)` available in libtmux v0.55.0.\n- **Implementation:** Session-level `enable_pane_titles`, `pane_title_position`, `pane_title_format` via `session.set_option()`. Per-pane `title` via `pane.set_title()`. Update tmuxinator importer for named pane syntax (`pane_name: command` → `title` + `shell_command`).\n\n### T4. No Session Rename Mode / `--here` CLI Flag\n\n- [ ] `tmuxp load` has no `--here` flag. Always creates new windows.\n- **Implementation:** Add `--here` to `cli/load.py`. For first window: `rename_window()` + `send_keys(\"cd \u003croot>\")` instead of `new_window()`. Also `rename_session()` when `--here` is used.\n\n### Dead Config Keys\n\n- [ ] Pop+warn for `socket_name`, `config`, `target`\n- [ ] Implement `clear` in builder (use `pane.clear()`)\n- [ ] Implement `start_window`/`start_pane` in builder (select matching window/pane after build)\n\n---\n\n## ~~Phase 3: libtmux Additions~~ — **COMPLETE**\n\nAll items shipped in [libtmux v0.55.0](https://github.com/tmux-python/libtmux/releases/tag/v0.55.0) (2026-03-07). Issue [libtmux#635](https://github.com/tmux-python/libtmux/issues/635) is **closed**.\n\n- [x] **L1.** `Pane.set_title(title)` — `pane.py:834-859` (unblocks T2)\n- [x] **L2.** `Server(tmux_bin=...)` — `server.py:131-146` (unblocks tmuxinator `tmux_command`)\n- [x] **L3.** Pre-execution `logger.debug` — `common.py:263-268` (unblocks T9)\n\n---\n\n## Phase 4: New CLI Commands\n\n### T5. No `stop` / `kill` CLI Command\n\n- [ ] tmuxp has no `stop` command. Add `tmuxp stop \u003csession>` — find session, call `session.kill()`. Run `on_project_stop` hook before kill.\n\n### T10. Missing Config Management Commands\n\n- [ ] Missing: `new`, `copy`, `delete`. Straightforward file operations.\n\n---\n\n## Phase 5: CLI Flags & Larger Features\n\n### T7. `--no-shell-command-before` CLI Flag\n\n- [ ] Skip `shell_command_before` for debugging. Equivalent to tmuxinator `--no-pre-window`. Simple flag addition.\n\n### T9. `--debug` / Dry-Run CLI Flag — **NOW UNBLOCKED**\n\n- [ ] **Previously blocked on L3** — now resolved. Pre-execution logging available in libtmux v0.55.0.\n- **Implementation:** Add `--debug` flag to `cli/load.py`. Capture DEBUG-level log output from libtmux to show tmux commands that would be executed.\n\n### T6. No Lifecycle Hook Config Keys\n\n- [ ] Config-driven shell command hooks (`on_project_start`, `on_project_exit`, etc.). Complex, needs design. Depends on T5 for `on_project_stop`.\n\n### T8. Config Templating\n\n- [ ] User-defined variable interpolation (Jinja2 or `string.Template`). Significant architectural addition.\n\n---\n\n## Dead Config Keys\n\nKeys produced by importers but silently ignored by the builder:\n\n| Key | Producer | Issue |\n|---|---|---|\n| `config` | tmuxinator | Dead data — extracted `-f` path unused |\n| `socket_name` | tmuxinator | Dead data — CLI uses `-L` flag |\n| `clear` | teamocil | Builder doesn't read it (libtmux has `Pane.clear()`) |\n| `target` (pane) | teamocil | Accidentally preserved (libtmux has `Pane.split(target=...)`) |\n| `shell_command_after` | teamocil | Builder has no after-command support (T3) |\n\n## Progress Summary\n\n| Phase | Status | Items |\n|---|---|---|\n| Phase 1: Import Fixes | **COMPLETE** | 7/7 |\n| Phase 2: Builder Additions | In progress | 1/5 done (T1 desugared) |\n| Phase 3: libtmux Additions | **COMPLETE** | 3/3 |\n| Phase 4: CLI Commands | Not started | 0/2 |\n| Phase 5: CLI Flags & Features | Not started | 0/4 |","author":{"url":"https://github.com/tony","@type":"Person","name":"tony"},"datePublished":"2026-03-07T00:56:36Z","url":"https://github.com/tmux-python/tmuxp/issues/1016"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:91432f1b-9594-31ce-a198-d40cc09de55c |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | A094:81DA9:DD1E0:12FD4D:6B008091 |
| html-safe-nonce | cb8f4d1eebc5fffe0aca19a8c62e4236db3d8c24ea3ce8fa8f8122ec7985c09f |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJBMDk0OjgxREE5OkREMUUwOjEyRkQ0RDo2QjAwODA5MSIsInZpc2l0b3JfaWQiOiI2NzQ2OTA4OTYyNTIxNjQ1MjAxIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | 803b0df07c6133f87cd1f908461cc5169943f7f56d1db4853903c55a890bd9e2 |
| hovercard-subject-tag | issue:4036845043 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/tmux-python/tmuxp/1016/issue_layout |
| twitter:image | https://opengraph.githubassets.com/4145b7aa883b82529e171b39e2550291c3f158feba3c9aaab11c5bff9c8d455a/tmux-python/tmuxp/issues/1016 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/4145b7aa883b82529e171b39e2550291c3f158feba3c9aaab11c5bff9c8d455a/tmux-python/tmuxp/issues/1016 |
| og:image:alt | Status (2026-03-15): All libtmux blockers resolved — libtmux#635 is closed. L1, L2, L3 all shipped in libtmux v0.55.0 (2026-03-07). tmuxp pins libtmux~=0.55.0. Phase 1 (import fixes) is complete (7... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | tony |
| hostname | github.com |
| expected-hostname | github.com |
| None | 82c186f13e104004ab7bdb779f3195e59dd38bfde531aaa74b76470fc2462b83 |
| turbo-cache-control | no-preview |
| go-import | github.com/tmux-python/tmuxp git https://github.com/tmux-python/tmuxp.git |
| octolytics-dimension-user_id | 37234308 |
| octolytics-dimension-user_login | tmux-python |
| octolytics-dimension-repository_id | 12398170 |
| octolytics-dimension-repository_nwo | tmux-python/tmuxp |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 12398170 |
| octolytics-dimension-repository_network_root_nwo | tmux-python/tmuxp |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | d1bc2aa1939001689f5ce935982c10a6138f745c |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width