The terminal
Your own shell is built into the window: type a command on the line under the panes, bring the terminal up over everything, or stand it in one pane’s place. It is the same shell each way, and it keeps running while you look at the panes.
- Row of tabs
- Each tab’s number and title, the one shown lit. A
•means a command is running in it, a?that it seems to be waiting for an answer. At its right end, the key to the tabs menu and the key back to the panes. - The shell’s screen
- Everything the shell and its programs write, in their own colors.
- Bottom row
- The function keys, numbered and nothing more, since bare they are the program’s. Hold ⌘ for a moment and it lists what each does with it.
At a glance
| Key | Action |
|---|---|
| ⌘L | Command line |
| ⌥⌘O | Terminal |
| ⌘F5 | Insert from the panes… |
| ⌘F8 | Command history… |
| ⌘F3 | Terminal's last output in the viewer |
| ⌘T | New terminal tab |
| ⌘G | Move the shell to a folder… |
| ⌥⌘T | External terminal here |
One shell, three places
The command line, the full terminal and the terminal beside a pane all show the same shell — the current tab’s.
- The shell starts the first time one of them is asked for, in the active pane’s folder.
- It runs whether or not you are looking: output arrives, commands finish, and it is where you left it when you come back.
- Your own terminal application is one key away too — below.
The command line
⌘L puts the keyboard on the row under the panes, which becomes your shell’s prompt. Type a command and press Enter; the same key gives the keyboard back.
- The arrows and page keys still move the pane’s cursor, so you can pick a file without leaving the line. Tab completes, as the shell always does.
- Taking the line moves the shell to the active pane’s folder, so a command runs where you are looking.
- A command that ends at once leaves you on the panes, with a short notice of how it went. One that runs on, or takes the whole screen, brings up the full terminal.
Everything about it — which keys are whose, the notice, putting names from the panes on the line, the history — is on The command line.
The full terminal
⌥⌘O gives the shell the whole window, and the same key goes back to the panes.
- Keys go to the shell and its programs, and the ones with ⌘ held are the application’s. Hold it and the bottom row lists them.
- ⌘L also goes back, with the keyboard on the line for the next command, and so does Esc twice at an empty prompt.
- Back on the panes, the active pane is in the folder the shell went to. ⌘[ takes it back.
- Each tab is a shell of its own: ⌘T opens one where the active pane is.
The screen, the tabs and the menus are on The full terminal.
Beside a pane
The terminal can stand in one pane’s place, next to the other pane — to see a folder and work in it at once.
- Open it from a pane’s places list: ⌥F1 or ⌥F2, then Terminal, the last row, on ⌥T. Or Show here › Terminal in that side’s menu of the menu bar — Terminal in the left pane, Terminal in the right pane. Terminal beside the pane, in the Terminal menu and the actions list (⌘K), puts it in place of the pane that is not active, and takes it away again.
- Close it by choosing any place from that side’s list: the pane comes back and goes there. Or choose Show here › Terminal again from that side’s menu, where it has a dot while the terminal is there. The shell keeps running.
- It shows the current tab’s shell, and has no tabs of its own. Its top row says where the shell is.
- The line under the panes is not there while it is: the terminal is where commands are typed.
| Press | And |
|---|---|
| ⌘← · ⌘→ | The keyboard goes to the left or the right side — the pane, or the shell |
| Tab on the pane | The keyboard goes to the shell. On the shell, Tab is the shell’s |
| ⌘L | The keyboard goes between the shell and the pane |
| ⌘U | The terminal and the pane change sides |
| ⇧⌘Enter | The side with the keyboard takes the whole width, and the shell is told its new size |
While the shell has the keyboard, keys go to it, and those with ⌘ held are the application’s. Hold ⌘ and the key bar names what the function keys then do. F10, with ⌘ held too as in the full terminal, lists the terminal’s options on its side of the panes’.
Following each other
While both are on screen, the pane and the shell keep up with each other:
- The pane follows the shell. When the shell changes folder, the pane beside it goes there, as a visit of its own, so ⌘[ returns.
- The shell follows the pane, more carefully, since a command runs where the shell is. Once the pane has stayed in one folder for half a second, a shell idle at its prompt moves there, and its top row says followed the pane. Arrowing through ten folders is one move, not ten.
- A shell running a command is left alone, and follows at its next prompt. A shell you are typing at is never moved.
Nothing is typed at the shell to move it, and nothing is added to its history. Both halves need the shell’s integration. Turning off Shell follows the pane stops the shell following the pane; the pane still follows the shell.
⌘G moves it on purpose, offering the folder of the pane beside it first — see Moving the shell.
Your own terminal application
⌥⌘T opens your usual terminal application in the active pane’s folder.
- Which one is Your own terminal. Left as automatic, it is iTerm2 where that is installed, Terminal otherwise; Ghostty, kitty and Warp can be named too.
- On the command line, the same menu that inserts from the panes can run what you have typed in iTerm2 or Terminal — see Running it in your own terminal.
- The other way round,
ncmdin any terminal opens a folder or a file in the application — see From any terminal.
More about the terminal
- The command line — which keys are whose, what a command leaves behind, putting names and paths on the line, the commands you ran, and running a line in your own terminal.
- The full terminal — showing it and going back, what is on its screen, tabs, its menus, how programs look, and quitting with shells running.
- Commands and their output — stepping from command to command, opening the files an error names, and reading output in the viewer.
- Keys, mouse and clipboard — what reaches the program and what the application keeps, the Option key, selecting, copying and pasting.
- The shell and its integration — which shell runs and how, what the integration scripts add, moving the shell, and what a program is never allowed to do.
- From any terminal — the
ncmdcommand: opening a folder or a file in the application from any terminal, and installing it. Every command and option is under Command line.