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:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user