Share the macOS window host, resume sessions, and group Linux windows
This commit is contained in:
@@ -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 |
|
||||
|
||||
Reference in New Issue
Block a user