docs(cli[import]): Document tmuxinator and teamocil fallback mappings

tony · tony · commit 3703f2a79778 · 2026-06-07T05:56:11.000-05:00
why: Make the importer's key mappings discoverable for users
migrating configs.
what:
- Note the fallback conversions on the import page
diff --git a/docs/cli/import.md b/docs/cli/import.md
@@ -38,6 +38,14 @@ $ tmuxp import teamocil /path/to/file.json
 
 ````
 
+### Supported teamocil fields
+
+The teamocil importer preserves top-level and `session`-wrapped configs, window
+`root`, `layout`, `clear`, `focus`, `options`, and `filters` entries. Pane
+entries using `cmd`, `commands`, string panes, and blank panes are converted to
+tmuxp pane dictionaries. Unsupported pane `width` and `height` values are
+dropped with a warning.
+
 (import-tmuxinator)=
 
 ## From tmuxinator
@@ -64,6 +72,18 @@ $ tmuxp import tmuxinator /path/to/file.yaml
 
 ````
 
+### Supported tmuxinator fields
+
+The tmuxinator importer maps `project_name`/`name`, `project_root`/`root`,
+legacy `tabs`, `cli_args`/`tmux_options` values for `-f`, `-L`, and `-S`,
+`socket_name`, `socket_path`, `pre`, `pre_window`, `pre_tab`, `rbenv`, `rvm`,
+`startup_window`, `startup_pane`, `synchronize`, pane-title keys, and lifecycle
+hook keys.
+
+Named pane entries such as `{logs: tail -f log/development.log}` become tmuxp
+pane `title` values. Imported `config` values are resolved relative to the saved
+workspace file when the workspace is loaded.
+
 ````{tab} JSON
 
 ```console
