Share the macOS window host, resume sessions, and group Linux windows

This commit is contained in:
James Magahern
2026-11-17 18:12:22 -08:00
parent a388944d73
commit 0f272d5298
9 changed files with 666 additions and 84 deletions
+23 -5
View File
@@ -35,10 +35,16 @@ codesign --force --sign - target/release/bundle/osx/psyTerm.app
open target/release/bundle/osx/psyTerm.app
```
You can copy `psyTerm.app` to Applications. The bundle and CLI both open a GUI
in the launching process. Press Cmd+N for another window with its own session,
or run `open -n` with the app path. The bundle's
`Contents/MacOS/psyterm` executable also accepts the CLI commands below.
You can copy `psyTerm.app` to Applications. All macOS windows share one Dock
icon. Closing a window detaches its session. Cmd+Q detaches every window and
keeps their shells, tabs, and scrollback in the daemon. Reopening the app from
Finder, the Dock, or `open` resumes the most recently detached local session,
including its SSH tabs. If all live sessions are attached, the app joins the
most recently used one. If none exist, it creates a session.
Press Cmd+N or run `psyterm` from a shell to start an independent session
in another window of the running app.
The bundle’s `Contents/MacOS/psyterm` executable accepts the same CLI commands.
### Linux
@@ -80,6 +86,18 @@ The default command starts or reuses a local server, asks its zygote to fork a
GUI, and returns. Each invocation starts an independent session unless you pass
`--attach`.
All Wayland windows use the app ID `dev.buzzert.psyterm`. Install the matching
desktop entry and icon with the release binary so the desktop can group windows
under the psyTerm launcher.
```sh
sudo install -Dm755 target/release/psyterm /usr/local/bin/psyterm
sudo install -Dm644 assets/dev.buzzert.psyterm.desktop \
/usr/local/share/applications/dev.buzzert.psyterm.desktop
sudo install -Dm644 assets/psyTerm.svg \
/usr/local/share/icons/hicolor/scalable/apps/dev.buzzert.psyterm.svg
```
### Shells and sessions
Each new session starts with one tab and one shell. A pane opened above or
@@ -122,7 +140,7 @@ Finish any running work first, since shutdown ends its sessions, then launch
| `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 --gui` | Open a window in the shared macOS app or run a Linux GUI in the current process |
| `psyterm --list` | Show local sessions, attached window counts, tabs, and panes |
| `psyterm --shutdown` | Stop the local server and end its sessions |
| `psyterm --server` | Run the terminal server in the foreground |