Add server-owned stacked panes with vertical navigation

This commit is contained in:
2026-11-17 02:08:02 -08:00
parent 4655f8149b
commit ec97ef00b0
10 changed files with 1129 additions and 136 deletions
+30 -10
View File
@@ -55,8 +55,8 @@ its zygote for new GUI windows, preserving existing windows and shells. Changes
to server logic or the protocol still require restarting the server;
`--shutdown` also ends its shell sessions.
This build uses protocol version 2. An older server must be restarted before
attaching; the new `psyterm --shutdown` command can stop a version-1 server.
This build uses protocol version 3. An older server must be restarted before
attaching; the new `psyterm --shutdown` command can stop version-1 and version-2 servers.
Finish any running work first, since shutdown ends its sessions, then launch
`psyterm` again to start the updated server.
@@ -112,6 +112,9 @@ run `psyterm --shutdown` on the remote host, for example through SSH.
| Alt+Left / Right | Focus the adjacent pane, then adjacent tab at the edge |
| Alt+Shift+[ / ] | Switch to the previous / next tab |
| Alt+Shift+N or Alt+Shift+Right | Create a tab |
| Alt+Shift+Up / Down | Insert a stacked pane above / below the current pane |
| Alt+Up / Down | Expand the previous / next stacked pane |
| Click a collapsed pane title | Expand and focus that pane |
| Ctrl+Shift+Left / Right | Focus the previous / next pane |
| Ctrl+Shift+W | Close the focused pane and its shell |
| Ctrl+Shift+R | Edit the pane name |
@@ -131,11 +134,12 @@ Zellij's modal Ctrl bindings are left to terminal programs.
The command palette searches command names and keywords as you type. Arrow keys
or Tab select a result; Enter runs it or opens a submenu. Escape returns to the
parent menu, then closes the palette. “Switch to tab…” and “Focus pane…” offer
live workspace lists. Commands without shortcuts, such as restoring automatic
pane names, are available here too. Palette input never reaches the shell.
live workspace lists, including collapsed panes. Commands without shortcuts,
such as restoring automatic pane names, are available here too. Palette input
never reaches the shell.
Typing returns to the live screen. Ctrl+C, Ctrl+D, Alt combinations, arrows,
navigation keys, and function keys reach the terminal application.
Typing returns to the live screen. Ctrl+C, Ctrl+D and unbound Alt combinations,
arrows, navigation keys, and function keys reach the terminal application.
Alternate-screen applications receive shifted navigation; the wheel sends
arrow keys when the application enables alternate scrolling.
@@ -146,6 +150,17 @@ with `~`; pane headers and equal-width tabs truncate long names in the middle.
It checks shell directories every 500 ms, including while the shell is idle. Manual names survive program title changes and client disconnects;
returning to automatic naming uses the latest program title or directory.
Tabs form the horizontal dimension; each column within a tab has an ordered
vertical stack. One pane per stack is expanded, with the other titles above and
below it. Creating or switching stacked panes uses the same curve as tab changes,
with vertical motion. Vertical navigation stops at the first/last pane. Side-by-side
splits create independent columns, each with its own stack. Long collapsed-title
lists scroll, leaving room for the expanded terminal.
Stack order, expanded panes, titles, and all shells live on the server and survive
GUI detach/reattach. Collapsed shells keep running; their grids are sent only when
expanded, and their output does not redraw unchanged visible grids.
When a shell exits, its pane closes automatically. An empty tab closes too,
and focus moves to an adjacent remaining pane or tab when needed. After the
last shell exits, the window stays open with `+` available to start another tab.
@@ -243,16 +258,21 @@ lifecycle, and server reattachment/layout behavior. Pane tests cover natural
shell exit, empty-tab removal, focus preservation, idle directory changes,
program/manual name precedence, title resets, and rename persistence. Editor
tests cover Unicode selection and composition; protocol tests pin the previous
version's shutdown handshake.
versions’ shutdown handshakes. Stack tests cover insertion, navigation, hidden
output, reattachment, and exit cleanup.
Live Hyprland checks verified GUI→zygote→server ancestry, a single-threaded
zygote, no server GPU descriptors, two simultaneous GUIs, tabs/splits, and shell
survival after detaching. An actual SSH connection to a separate headless
server on localhost verified input and reattachment. Replacing a running
executable refreshed its zygote while the original GUI and shell stayed alive.
These are Linux checks; remote-network latency and macOS remain unverified.
New live checks cover palette search/submenus and input isolation, Zellij
navigation bindings, stack insertion in both directions, collapsed-pane focus,
exit cleanup, and stack reattachment. A second client's focus changes preserve
palette input. These are Linux checks; remote-network latency and macOS remain
unverified.
Linux Wayland is the implemented platform; macOS is a future target. Current
limits include side-by-side panes only, shared per-server viewport state, no
disk-restored sessions, no configuration files, no application mouse reporting,
limits include no arbitrary split trees or floating panes, shared per-server
viewport state, no disk-restored sessions, no configuration files, no application mouse reporting,
no Kitty keyboard protocol, no OSC 52 clipboard access, and no clickable links.