Sessions and tabs
- On Mac and iPad, each session is a tab. Cmd+T opens a new tab, where you find a server or type
user@hostand press Return. Cmd+1 to Cmd+9 switch tabs. - Drag a tab along the bar to change the order. On Mac, drag it down out of the bar and it opens in a window of its own (Pro), its session still running; drag it into the bar of the main window and it goes back where you let it go.
- Right-click a tab, or touch and hold it, for its session menu, which ends with Move to new window (Mac), Close other sessions and Close sessions to the right. In a separate window, right-click a tab for Back to main window.
- Right-click the empty part of the bar for New tab and Reopen closed session (Shift+Cmd+T), which connects again to the servers of the session closed last.
- On iPhone, the Connections tab lists the active sessions. Swipe left on one to close it.
The session row on iPhone
At the bottom of a terminal on iPhone, one row holds, from left to right:
- the back arrow, to the list
- the session in front, with the logo of the system, the name and the address, in the colour of its state. Tap it for the list of open sessions. Its x closes that session.
- +, a new session on a server you pick in the list
- the square, with the number of open sessions. The number turns to the accent colour when a session behind has new output. Tap the square to see all open sessions side by side.
To go to the next or the previous session, slide two fingers left or right on the terminal. Tap the terminal to open the keyboard.
Double-tap the square to go back to the session you were in before.
All sessions at a glance on iPhone
The square shows up to four live terminals at a time; swipe sideways for more. Each one shows what happened while you were elsewhere: a dot for new output, a check when a command finished, a note when the connection dropped, a red edge for a production server.
- Tap a terminal to bring it in front.
- Touch and hold one, then drag it to change the order of your sessions.
- Touch and hold without moving for its menu: Duplicate, Reconnect, Move to Top, Share session and Close session.
- Swipe one up to close it.
- Tap the last tile, +, for a new session.
- Tap Select, pick the sessions, then Type to all. A panel opens over the keyboard with how many sessions receive it and a field: write a command and tap Send, or Return on the keyboard, and it runs in all of them. The field empties for the next one, and the tiles above show the results. Tap a tile to leave it out or bring it back. Done stops it and goes back to the terminal.
With the keyboard open, the row sits right above the key bar. Closing the last session goes back to the list.
Split panes and workgroups
On Mac and iPad a tab can hold several panes. Under More, Layout arranges them: two side by side, two stacked, four in a grid, or one large and two, with Option+Cmd+1 to Option+Cmd+4. Even sizes makes them the same size again. Shift+Cmd+Return focuses one pane, and Show all panes brings the others back.
- Save as workgroup keeps the servers and the layout, to open them together again from Workgroups (Pro). The menu of a workgroup has Open, Rename and Delete.
- Type to all sends what you type to every pane. A bar shows how many panes receive it. With production servers among them, the app asks first.
- Send to several sessions sends one line to the sessions you choose.
All sessions side by side
On Mac and iPad, the grid button at the right of the tab bar shows every open session side by side, in a grid that fits how many there are: two side by side, three or four in two rows, and so on. It is also in the View menu as Tile all sessions (Shift+Cmd+\). Press it again, or choose Back to tabs, and your tabs are as they were. Double-click the name of a session to go back to the tabs on that one.
- Click a session to type in it alone.
- Type to all (Shift+Cmd+I) opens a panel under the sessions with how many receive it and a field: write a command and click Send, or press Return, and it runs in all of them. The field empties for the next one, and the sessions above show the results.
- While the panel is open, click a session to leave it out or bring it back. With production servers among them, a risky command asks first.
- Done, or Esc, closes the panel.
The side panel
The side panel holds Server, Saved commands, History, Files, Containers and Appearance next to the terminal. Open it with the side panel button, or with Cmd+. on Mac and iPad.
On iPhone, tap the side panel button at the top right, next to .... On iPhone and iPad, when there is no room for the panel beside the terminal, it slides in from the right over the whole screen, with an icon for each tab. Close it with Done or by dragging it to the right. It opens again on the last tab you used.
- Server: CPU, memory, disks and network of the server. See Server stats.
- Saved commands: a tap writes the command on the line without running it, the play button runs it. See Saved commands.
- History: the commands run on this server, to run, copy or save as a command.
- Files: the files of this server, in the folder of the shell. See Files over SFTP.
- Containers: the Docker or Podman containers of the server. See Containers.
- Appearance: font, text size and theme.
Passwords and paste
- When a command such as
sudoorsuasks for a password, the app offers Enter saved password if the server has one: a tap types it into that question only. Otherwise Enter password opens a field, with Remember it for next time to save it in the server. If the saved password is refused, the app offers Update password. - Before pasting hidden characters or a risky command, the app shows Paste this? with the text, and removes the hidden characters.
Themes and text
- Settings, Terminal sets the text size, the theme and the font of every terminal. See Settings.
- A server or a group can have its own theme: Show more, Terminal, Theme.
- Cmd+Plus and Cmd+Minus change the text size. On iPhone and iPad, pinch.
Suggestions while typing
As you type, suggestions from your history, your saved commands and the server's folders, commands and options appear: above the keys on iPhone and iPad, under the cursor on Mac. The likeliest come first, from what you run on this server, in this folder and lately. A tap, or the right arrow, adds a suggestion to the line. Return stays with you.
With Predict next command, an empty prompt suggests what you usually run next. For example, after
cd /var/www/appit suggests git pull, and after git pull it suggests npm run build. It learns from the commands you run on this device, and what it learns stays there.
- On iPhone and iPad the suggestions keep their place above the keys, so the terminal stays still.
- To turn them off for one session, choose Suggestions in the session menu, or touch and hold the suggestions and choose Hide for this session. On Mac, right-click the list.
- Settings, Terminal: Suggestions while typing turns them off everywhere, Predict next command turns off the suggestions at an empty prompt and the learning. Under Show more, Forget learned habits starts over and keeps your command history.
Shell integration
With shell integration, the app knows where each command starts and ends. A mark next to each prompt shows whether the command succeeded, with its exit code and how long it took, and you can jump from command to command (Cmd+Up and Cmd+Down) or copy one command's output.
- In the session menu choose More, then Shell integration.
- The app shows the lines it would add for bash, zsh or fish, and the file they go in.
- Choose Add. The app keeps a copy of the file first. Remove takes the lines out again.
- Open a new session to use it.
Shortcuts on Mac
- Cmd+K: Find anything, servers, commands and places
- Cmd+J: Ask for a command, see Ask
- Cmd+N: new server; Cmd+L: new local terminal
- Cmd+Y: command history, in the Session menu; Cmd+.: side panel
- Option+Cmd+1 to Option+Cmd+4: layouts of the panes
- Shift+Cmd+\: all sessions side by side; Shift+Cmd+I: Type to all
- Shift+Cmd+] and Shift+Cmd+[: next and previous session
- Shift+Cmd+T: reopen the closed session
- Shift+Cmd+L: lock the app.