Close local tabs and detach or reattach live SSH sessions

Remember the remote daemon and session identity for hostless reattachment. Keep other tabs usable after a discarded snapshot and preserve the last live detach target when a remote shell exits. Reject remote flags for local daemon control commands.
This commit is contained in:
James Magahern
2026-11-17 16:15:28 -08:00
parent f2390ca9b4
commit 153838061e
12 changed files with 874 additions and 162 deletions
+19
View File
@@ -114,6 +114,7 @@ Finish any running work first, since shutdown ends its sessions, then launch
| `psyterm` | Open a new local session in a new window |
| `psyterm --attach [ID]` | Open a window on an existing session |
| `psyterm --remote user@host` | Start a fresh SSH session in an adjacent tab when run from a local psyTerm pane, or a new window when run elsewhere |
| `psyterm --remote --attach` | Reopen the last remote session you detached |
| `psyterm --remote user@host --attach [ID]` | Reattach to an existing session on the SSH host |
| `psyterm --gui` | Run the GUI in the current process |
| `psyterm --list` | Show local sessions, attached window counts, tabs, and panes |
@@ -144,6 +145,22 @@ to find remote session IDs. Closing the window and reattaching to the local
session restores its mixed tab bar. The **+** button creates a local tab in
this workspace. Splitting a remote pane creates another shell on its SSH host.
To detach, hover over a remote tab and click **×**, or focus it and choose
**Detach remote session** in the command palette. If that SSH session has
several tabs, they detach together. Its shells, running jobs, and scrollback
stay on the remote host. **Close pane** still ends the shell in that pane.
Run `psyterm --remote --attach` from a local pane to bring back that
workspace’s last detached remote session in the tab bar. From outside
psyTerm, the same command reopens the most recently detached remote session
in a window. The local daemon remembers these targets until it exits.
If you detach a nested SSH session, run the command on the host that opened it.
You can also select a session explicitly with `psyterm --remote user@host --attach ID`.
The workspace’s daemon must be running this build for the tab close button
and remote detach history. Existing protocol-v6 sessions on the SSH host
can stay running.
SSH uses `BatchMode=yes`. Configure key or agent authentication and trust the
host key before connecting. The remote host needs a compatible `psyterm`
executable on its noninteractive SSH `PATH`. To use a different path, set
@@ -181,6 +198,8 @@ run `psyterm --shutdown` on the remote host, for example through SSH.
| Jump to oldest history / live screen | Shift+Home / End | Shift+Home / End |
Click a tab to switch, `+` to create a tab, or a collapsed pane title to expand it.
Hover over any tab to show its **×** button. On a local tab, it closes the tab
and all its shells. On a remote tab, it detaches the SSH session.
Drag, double-click, or triple-click to select text, a word, or a line. Scroll with
the mouse wheel or touchpad. Closing the window detaches the GUI and keeps the
server sessions running.