Cycle pane input modes with Mode and retain terminal tag access

4 files changed, 17 insertions, 13 deletions

diff --git a/docs/config.md b/docs/config.md
index 42163f2b..2474c6b0 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -320,7 +320,7 @@ can set `PARDES_V9FS_HELPER` to its absolute path. See [v9fs.md](v9fs.md).
 Ctrl-B switches between raw TTY and editor mode. Plain Escape at a detected
 shell prompt hops back to the previous pane. Other keys, including Ctrl-O, Ctrl-W,
 paste shortcuts, and modified Escape belong
-to the child. Use `Togglettymode` in the pane tag to return to editor
+to the child. Use `Mode` in the pane tag to return to editor
 mode in place. Desktop paste events still feed the terminal.
 
 `Font` and `FontSel` exist ONLY in the SDL GUI and native macOS builds — a
diff --git a/docs/helix-keys.md b/docs/helix-keys.md
index 7675e73b..9dc86ee2 100644
--- a/docs/helix-keys.md
+++ b/docs/helix-keys.md
@@ -426,9 +426,9 @@ pinned to Spaces(4), smart-tab off, and the buffer-setup transaction
 committed as its own undo revision. Build:
 `cargo build --release -p helix-term --features helix-term/integration --bin hx-harness`.
 
-Raw TTY input keeps Ctrl-b for `Togglettymode` and unmodified Escape at a detected shell
+Raw TTY input keeps Ctrl-b for the terminal/editor toggle and unmodified Escape at a detected shell
 prompt for `Last`. Other Ctrl/Alt chords, modified Escape, and clipboard shortcut
-keys go to the child. Use the `Togglettymode` tag to leave raw input in place.
+keys go to the child. Use `Mode` in the tag to leave raw input in place.
 
 Completed mouse rectangles keep their source text when jump navigation scrolls
 the pane. Wrapped pieces stay separate copied rows. Changing file content or
diff --git a/docs/tags.md b/docs/tags.md
index 0e0fb85d..20c8c67a 100644
--- a/docs/tags.md
+++ b/docs/tags.md
@@ -68,11 +68,15 @@ tail, without displaying the current tint state. `PdfFit` (`SPC t z`) remains
 available, as do the shortcuts for `PdfTint` (`SPC t i`) and `PdfSections`
 (`SPC t s`, or `f` on a PDF).
 
-Terminal tags include `Togglettymode`, which toggles between normal editor mode and raw
-terminal input. Ctrl-B enters terminal input from editor mode; raw TTY mode
-forwards it to the child. The tag command also works while editing
-the tag: the command leaves tag editing and toggles the parked body mode.
-Executing it on a non-terminal pane does nothing.
+Terminal tags include `Mode`, which cycles through raw terminal input, normal
+editor mode, insert mode, and back to terminal input. On files and text output
+panes, `Mode` cycles between normal and insert mode; it is available as a command
+but does not appear in their default tags. Images and PDFs keep their normal mode.
+Executing `Mode` from a tag leaves the tag and advances the parked body mode.
+
+Ctrl-B keeps its terminal/editor toggle. Existing custom tags can still use
+`Togglettymode` for that two-way terminal toggle. Old default terminal tags
+upgrade to `Mode`; customized command text is preserved.
 
 ## Saved workspaces
 
diff --git a/docs/ui-review.md b/docs/ui-review.md
index e43ef9b7..2438f2ef 100644
--- a/docs/ui-review.md
+++ b/docs/ui-review.md
@@ -41,8 +41,8 @@ sent to the user's session.
 ## Compact rails, classic palettes and workspace pets
 
 `New` now belongs to column tags only. Pane tags keep their local save,
-terminal and close actions: `Tty` opens a terminal, and `Togglettymode`
-switches editor/raw input using the same transition as Ctrl-B. Historical
+terminal and close actions: `Tty` opens a terminal, and `Mode`
+cycles raw input, normal editing and insert mode. Historical
 default pane tails upgrade during Restore; explicitly customized text remains
 owned by the user.
 
@@ -85,10 +85,10 @@ the native contrast tests.
 
 PDFs now use `filename.pdf [page/total] Tty Del PdfSections PdfTint Collapse`,
 keeping sections and tint commands visible without the long generated
-control/status prefix. Terminal tags add `Togglettymode`, sharing Ctrl-B's actual mode
-transition, including when invoked from an edited tag.
+control/status prefix. Terminal tags include `Mode`, which cycles the body mode
+even when invoked from an edited tag. Ctrl-B keeps its two-way toggle.
 
-`test/tag_cleanup.py` verifies the compact PDF tag, middle-click `Togglettymode`, Ctrl-B,
+`test/tag_cleanup.py` verifies the compact PDF tag, middle-click `Mode`, Ctrl-B,
 and tag-edit/Tab execution through real host input and 9P observations on both
 SDL and TTY. The PDF source stays unchanged. The full unit suites pass 773 TTY
 tests and 797 SDL tests; SDL image/PDF and Kitty PDF rendering harnesses pass.