Terminal
The Gatesys SSH terminal: tabs and split panes, live host metrics and Health, snippets, find, asciinema session recording and the command palette.
The terminal is a full-width xterm.js shell on the host’s one SSH session. Terminal tabs and split panes are extra channels on that session, not extra connections, so they open instantly and never renegotiate the jump chain.
More than one terminal per session is Gatesys Pro
Free gives each session one terminal, and you can open sessions to as many hosts as you like, each with its SFTP and tunnels. A second terminal tab or a split pane in the same session is part of Gatesys Pro. See plans
Sessions and terminal tabs
Each connected host gets a session tab in the title bar, and the + after the session tabs opens a new session. With Gatesys Pro, a session holds up to twelve terminal tabs.
| To | macOS | Windows and Linux |
|---|---|---|
| Open a terminal tab (Pro) | ⌘T or + in the tab row | CtrlShiftT or + in the tab row |
| Close the terminal tab | ⌘W | CtrlShiftW |
| Go to tab 1 to 9 | ⌘1 … ⌘9 | CtrlShift1 … 9 |
| Next or previous tab | CtrlTab / CtrlShiftTab, or ⌘Shift] / [ | CtrlTab / CtrlShiftTab |
On Windows and Linux the tab shortcuts carry Shift, so the shell keeps CtrlT, CtrlW and the rest.
With one terminal tab left, ⌘W closes the session. You can also close a session with the × on its title-bar tab. Closing a session closes all its tabs and panes. Tabs and splits live only as long as the session; they are not restored after a restart.
If the connection carries tunnels, closing its tab asks first and can keep the connection open for them. See Port forwarding.
To open a shell on this computer rather than on a server, use This computer at the top of the Hosts list or ⌘ShiftT (CtrlShift`). See Local terminal.
Without Pro
- The + in the tab row and Split wear a Pro tag. Clicking either, or pressing ⌘T (CtrlShiftT), opens a small card that says what the feature adds, with Get Pro. Esc or a click elsewhere closes it.
- To work on another host at the same time, open a new session with the + in the title bar. Each session has its own terminal.
- If your licence ends while a session has several terminals open, they all stay open until you close them. Only a new tab or split asks for Pro.
Split panes
With Gatesys Pro, each terminal tab splits into up to four panes.
- Click Split in the tab row to split the focused pane.
- Use the arrow beside it for Split right, Split down or Close focused pane.
- Drag the divider between panes to resize them.
On a server that limits how many channels a login may open, a split the server refuses fails on its own; the other panes keep working.
The terminal header
The header names the host, shows the jump chain it came through and its uptime, and carries the metric strip: live cards for the host’s CPU, MEM (memory), DISK, LOAD, NET (network), PROC (processes) and THR (threads), each with a sparkline. Load is shaded against the host’s core count.
Click a card to see why a number is high. A dialog, such as CPU detail on db-primary, offers read-only commands for it, for example Top processes by CPU. Pick one and click Insert only to put it on the prompt, or Run to run it in the focused pane. Hover or focus a card for Ask Farabi, which asks about that figure’s last hour.
Beside the metrics, the Health pill says what the numbers mean, such as 3 issues · 1 risk, and opens the Health panel with its signals and the top processes. A card with a signal on it wears a coloured dot. See Server health.
Under the header, a slim strip shows what Gatesys SSH read about the host and what changed since your last visit. See Host facts.
The tab row
The row above the shell holds the terminal tabs, the + for a new one (Pro), and these buttons:
| Button | What it does |
|---|---|
| Snippets | Runs a saved command in the focused pane |
| Split | Splits the focused pane (Pro) |
| Watch | Tells you when a command finishes, a line appears or a metric stays past a limit. See Watchers |
| Record | Records the focused terminal to a .cast file |
| Farabi | Shows or folds Farabi’s panel. See Farabi beside the shell |
Snippets
Snippets are saved commands, one click away in any session.
- Open Vault › Snippets and add one with a Name, a Command and an optional Description.
- In a terminal, open the Snippets menu and click the snippet. It is sent to the focused pane followed by a newline.
Sort the menu by your own order (drag snippets in the Snippets view), by most used, or by name. You can also save a command Farabi suggested as a snippet. Every snippet run is written to the audit log.
Suggestions while you type
A list under the cursor finishes the line you are typing. It is code, not a model, so nothing you type is sent anywhere to be completed, and it works on the Free plan. It needs bash or zsh on the host and is off until you turn it on.
- Click Suggestions in the terminal header. Open The line it types to read it in full, then click Turn on in this shell. For a host you use every day, tick Turn on terminal suggestions at connect in the host editor.
- Type two characters, or press CtrlSpace. The list shows at most eight rows, best first.
The line is the only thing the app types into your shell for this. It is under 1,000 bytes, asks bash or zsh to mark where the prompt ends, writes nothing to the server’s disk and ends with the shell. Turning it on is written to the audit log. On any other shell it changes nothing.
| Source | Offered when |
|---|---|
| Snippets | What you typed starts a snippet’s command or name |
| History | What you typed starts a command you ran on this host |
| Common verbs | After systemctl, docker, git, journalctl, kubectl or apt |
| Services | After systemctl restart or journalctl -u: failed units and the services of packages the app measured |
| Containers | After docker logs, docker restart and the like: containers from Host facts |
| Paths | The word you are typing looks like a path: a folder listing over the session’s own SFTP channel |
Picking a row only types text. It never presses Enter, and it does nothing if you kept typing after the list was made. Each row is rated with the command-safety rules: a command a blocking rule refuses is not offered, and a risky one carries its marker. Until you step into the list, your shell keeps ↑, Tab and Enter. See Keyboard shortcuts for the keys.
Suggestions stay out of the way in full-screen programs such as vim and less, and while you search history with CtrlR. A shell started inside the session, such as the one sudo -i opens, does not mark its prompt, so it gets none.
Settings › Terminal has a switch for Suggestions while you type, one for Remember what I run and a button that clears what was kept. The history is per host, on this computer only, encrypted with your vault key, 500 lines for 90 days. A line that starts with a space, or that the app’s secret scrubber would change, is never kept, and none of it goes to a model. For the full story, see Autocomplete over SSH, without installing anything.
Copy, paste and the right-click menu
| Copy | Paste | |
|---|---|---|
| macOS | ⌘C | ⌘V |
| Windows | CtrlShiftC, or CtrlC while text is selected | CtrlShiftV, or CtrlV |
| Linux | CtrlShiftC | CtrlShiftV |
CtrlC is the shell’s interrupt, so with nothing selected it still interrupts. Copying with it lets the selection go, so the next press interrupts. On Linux the plain Ctrl keys stay with the shell, where CtrlV quotes the next key.
Right-click a pane for Copy, Paste, Select All, Clear and Find. The menu is the system’s own, opened by the app rather than drawn by the page, so nothing running in the page can trigger a paste or read your clipboard. A program that reads the mouse, such as tmux with mouse mode on, keeps the right button; hold Shift to open the menu over it.
Find text
Press ⌘F (CtrlF), or choose Edit › Find in Terminal. Enter finds the next match, ShiftEnter the previous one, and Esc closes the search.
Record a session
- Click Record in the tab row. It shows the elapsed time while recording.
- Click it again to stop. The saved file’s length, size and path appear, with Show in folder.
Recordings are asciinema v2 .cast files of what the shell printed. They hold output only, never keystrokes, so passwords you type stay out. Files are written to the app’s own data folder with owner-only permissions (mode 0600). Play one back with asciinema:
asciinema play session.castRun a command when the shell opens
In the host editor, Advanced › Run on shell open sends a command once, as soon as the interactive shell is ready, for example cd /srv && tail -f app.log.
Links in the terminal
Only http and https links open from a terminal, and never one that carries a user name or password. A link whose host uses punycode or mixes alphabets, and every OSC 8 hyperlink, first shows you the real host and asks. A server cannot write to your clipboard (OSC 52 is ignored). See Terminal links and escapes.
The command palette
Press ⌘K (CtrlK) or click the search box on the right of the title bar, before the theme toggle and the bell. The palette opens under it, lined up with its right edge. Type to filter, move with the arrow keys, press Enter to go and Esc to close.
| Type | What it does |
|---|---|
| A host | Opens or joins its session |
| A snippet | Opens the Snippets view |
| A view | Goes to Hosts, Terminal, SFTP, Port forwarding, Keychain, Snippets, Audit log or Settings |
| Explain changes on … | Opens Explain for a host that changed since your last visit (Pro) |
| Change a file with Farabi | Opens a reviewed config change on the live session (Pro). With the assistant off or without Pro, Quick change to sshd_config |
| New local terminal | Opens a shell on this computer with your default shell. Each shell also has its own entry, such as fish — new local terminal |
Farabi beside the shell
Farabi, the assistant, has a panel to the right of the terminal. It starts folded to a slim tab on the right edge, so the terminal has the full width. Press ⌘I (CtrlI), click Farabi in the tab row, or click the slim tab to show it, and the shell refits to the width left. The same keys and button fold it again, and the app remembers whether you left it open. Drag the panel’s left edge to resize it between 360 and 520 px. Below about 1100 px wide, it opens as a drawer over the terminal instead. See Farabi.
Terminal settings
Settings › Terminal holds, under Display, the font, size, colour scheme and scrollback (lines kept per terminal). Under Local terminal it sets the default shell for local terminals and your own shell profiles.
Settings › General holds the rest:
- Appearance: the theme (Light, Dark or System) and the accent colour.
- Notifications › System notifications (on by default): OS notifications for watch alerts, saved edits and critical Health signals when you are away from the window.
- Notifications › Show output lines in notifications (off by default): include the line that triggered an alert. Needs System notifications on.
Something unclear or wrong? Tell us.