Terminal
Free & PremiumThe Terminal is a full terminal inside the editor: a shell, Claude Code, a dev server or vim run in it just as in a terminal app of their own. By default it sits in the bottom dock and opens with ⌥F12. Every project has its own terminals; a new one starts in the project folder.
What you do here
- Tabs and split view: new terminals, split, rename, open as an editor tab, search the scrollback
- Keys: which shortcuts belong to the editor, Mac habits, ⌥ as Meta, ⌘K
- Links: click file paths and web addresses in the output
- Notifications: a notification when a program needs you
- SSH terminal: a shell on a server (Premium)
Page layout
- Tab strip at the top: one tab per terminal, then the version badge, New terminal (+), Move to editor tab and Terminal settings (…).
- Terminal area below, split into several terminals side by side or stacked if you like.
With WebDonkey running, php, node and composer in the project folder use the site's version. The badge at the right of the tab strip (such as “PHP 8.4 · Node 22 · shop.test”) names it; a click on it switches the version. More under WebDonkey.
A program in the terminal gets every key. Only a short list of ⌘ shortcuts belongs to the editor, see Keys.
Free and Premium
The local terminal is free. SSH terminals on servers are Premium.
Settings are under Settings › Terminal, see Terminal settings.
Tabs and split view Free
At the top of the Terminal window there is a strip with one tab per terminal, as in iTerm. Every tab can be split so that several terminals run side by side or stacked. You can also bring a terminal into the code area as a tab, next to your files.
Where to find it
- ⌥F12 shows and hides the Terminal window.
- ⌘T opens a new terminal, even while the window is closed. Only in the Git window is ⌘T Pull.
- The Terminal menu in the menu bar and the command palette (⌘K) with every terminal command, such as Terminal: New terminal as editor tab.
How to do it
- New terminal (+ in the strip or ⌘T) opens a tab in the project folder. If a terminal has the focus, the new one starts in that terminal's current folder.
- ⌘D splits the focused terminal to the right, ⇧⌘D downwards. The active terminal of a split has a coloured edge at the top. Drag the divider with the mouse; it snaps at ¼, ⅓, ½, ⅔ and ¾.
- ⌘W closes the focused terminal. If a program is still running in it, the editor asks “… is still running in this terminal”. A middle-click on the tab or the X on hover closes as well, in a split all terminals of the tab.
- Double-click the tab or Rename… in the context menu gives it a name of its own. Leave it empty to get the automatic name back. If Claude is running in the terminal, the name belongs to the Claude session and shows in its lists too.
- Reorder tabs by dragging them along the strip.
The tab
- By default the name follows the program that is running, for example
zshorclaude. In a split the number of terminals follows in brackets. - An icon shows the kind: terminal, Claude (asterisk) or server (globe, red for production).
- A coloured dot means a program in this tab called for you while you were elsewhere, see Notifications.
- The tooltip names the current folder, for servers the connection too.
A tab's context menu: New terminal (⌘T), Split right (⌘D), Split down (⇧⌘D), Rename…, Move to editor tab, Clear and Close (⌘W).
In the terminal area
Right-click in a terminal: Copy (⌘C), Paste (⌘V), Clear, Find (⌘F), Split right, Split down, Move to editor tab or Back to the terminal window, and Close.
⌘F opens the field Find in scrollback at the top right. It finds matches while you type, ↩ jumps to the next, ⇧↩ to the previous, Esc closes. Without a match the text turns red.
Drag files from the project tree or the Finder into a terminal and their paths land at the prompt. If Claude Code is running there, they arrive as mentions in Claude's input.
As an editor tab
Move to editor tab (button in the strip or context menu) puts the terminal into the code area, next to your files. Dragging the tab there does the same. The program simply keeps running.
You get it back with Back to the terminal window or by dragging: onto the Terminal window's tab strip (the tab lands where the pointer is), onto the Terminal window itself or onto its icon in the stripe.
When a program ends
- If you end the shell with
exit(code 0), the terminal closes. - If a program ends with an error, the terminal stays open so you can read the output. It says “[Process exited with code …]”; ⌘W closes it.
Settings
- Bigger font, Smaller font and Default font size (⌘+, ⌘−, ⌘0) in the strip's Terminal settings menu (…). The size ranges from 9 to 28, the default is 13.
- With no tab and no file open, the terminal fills the whole editor area. Turn it off under Settings › Terminal › Terminal fills the editor area when no tab is open.
- The Terminal window can be moved like any tool window, opened in a window of its own or maximized, see Layout.
More settings such as shell, cursor and scrollback: Terminal settings.
Tip
When you close a project, idle terminals close. Programs still running stay alive and are back when you open the project again.
See also
Keys Free
In the terminal every key belongs to the program running in it: Claude Code, vim, htop or the shell. The editor keeps only a short list of ⌘ shortcuts for itself and translates a few Mac habits into what terminal programs expect. Control keys such as ⌃C or ⌃R always go to the program.
Editor shortcuts in the terminal
| Key | Effect |
|---|---|
| ⌘T | New terminal |
| ⌘D / ⇧⌘D | Split right / Split down |
| ⌘W | Close terminal |
| ⌘F | Find in scrollback |
| ⌘C / ⌘V | Copy / Paste |
| ⌘K | command palette or clear the terminal (your choice, see below) |
| ⌘⎋ | from the terminal back to the editor. In the editor: open the project's Claude terminal. |
| ⌘+ / ⌘− / ⌘0 | font bigger, smaller, default |
| ⌥F12 | show and hide the Terminal window |
| ⌘1, ⌘2, ⌘9 … | the other tool windows |
| ⇧⌘F / ⇧⌘R | Find in files / Replace in files |
| ⇧⌘' | maximize the tool window |
| ⇧⌘F12 | hide all tool windows |
| ⌘, | Settings |
Mac habits
| Key | Effect |
|---|---|
| ⌘← / ⌘→ | to the start / end of the line |
| ⌘⌫ | delete to the start of the line |
| ⌥← / ⌥→ | jump by word |
| ⇧↩ | new line in Claude's input, no setup needed |
⌥ as Meta
Many terminal programs use Meta keys, Claude Code for example ⌥P or ⌥T, the shell ⌥B and ⌥F. On some keyboard layouts, German for instance, ⌥ also types @, |, [, ], { and }. Under ⌥ as Meta you choose what applies:
- Automatic (default): ⌥ with a letter becomes Meta, characters like @ | [ ] { } € stay typeable. Dead keys (such as ⌥N for ~) compose the character as in the macOS Terminal. That fits every keyboard layout.
- Always: every ⌥ key is Meta.
- Never: ⌥ only types characters.
Set it in the strip's Terminal settings menu (…), under Settings › Terminal or in the command palette (Terminal: ⌥ as Meta).
⌘K in the terminal
⌘K in the terminal opens the command palette by default, as everywhere in the editor. If you are used to ⌘K clearing other terminals, switch it to Clears the terminal, in the Terminal settings menu or under Settings › Terminal. Clear is also in the context menu.
Copying
Selected text is copied with ⌘C. With Copy on select (Settings › Terminal, off by default) every selection goes to the clipboard right away.
Troubleshooting
| What you see | What to do |
|---|---|
| Text looks garbled | switch Renderer from GPU (WebGL) to DOM (most compatible) |
| ⌥ does not type @ or [ | set ⌥ as Meta to Automatic or Never |
| Claude does not react to ⌥P | set ⌥ as Meta to Automatic or Always |
See also
Links Free
Whatever looks like a file path or a web address in the terminal is clickable. That helps with Claude Code, PHPStan, test runners or compilers that print error locations as file:line: one click opens the file at exactly that spot in the editor.
How to do it
- Move the mouse over a path or an address. It gets underlined and the pointer turns into a hand.
- Click. A plain click is enough, ⌘-click works too.
Dragging and double-clicking still select text: a plain click opens only after the double-click time, and only if you selected nothing. Hyperlinks a program sets itself (OSC 8) open with ⌘-click.
File paths
src/Checkout.php:42:7orFile.ts(12,3)opens the file at line 42, column 7 or line 12, column 3.- Recognised are paths with folders and file names with a known extension, such as
.php,.twig,.ts,.json,.yaml,.scss,.md,.logor.env. - Relative paths count from the folder of the program that printed them, then from the project folder. So paths from Claude running in a subfolder but counting from the project work too.
~/stands for your home folder.- A path only opens if the file exists.
- A path the terminal wraps over two lines is still one link.
Web addresses
https://…, http://… and mailto: open in the browser or the mail app. Punctuation at the end (“see https://x.io.”) and a closing bracket that was opened before the link are not part of it.
On a server
In an SSH terminal a path opens the file on the server, as a server file with a working copy (see Files on the server). Relative paths count from the shell's current folder.
Troubleshooting
| What you see | Why |
|---|---|
| The path is not underlined | It has neither folders nor a line number nor a known extension, or it is glued to other text. |
| A click opens nothing | There is no file at that path, neither from the program's folder nor from the project folder. |
See also
Notifications Free
Programs in the terminal can call for you, Claude Code for example when it waits for your answer, or a build that is done. The editor shows this in two ways: a dot on the tab and, when the editor is in the background, a macOS notification.
Dot on the tab
If a program calls while you are not typing in that terminal, its tab gets a coloured dot. It goes away as soon as you open the terminal again.
Notification
When the editor is in the background, it sends a notification:
- Claude is waiting for you when a Claude session waits for an answer.
- otherwise the terminal's name as the title, below it the program's text and the project's name. Without text it reads The terminal needs your attention.
Triggers are the terminal bell and the notifications programs send themselves (OSC 9 and OSC 777). The first time, macOS asks whether WebDonkey Editor may send notifications.
Setting
Settings › Terminal › Bell:
- Notification when the window is in the background (default)
- Off: the terminal bell triggers neither a notification nor a dot. Notifications programs send themselves (OSC 9 and OSC 777) still arrive.
Clipboard
Programs such as tmux, vim or Claude over SSH may write to the clipboard through the terminal (OSC 52). So you can copy from a session on a server too.
Troubleshooting
| What you see | What to do |
|---|---|
| No notification | Check in the macOS System Settings under Notifications whether WebDonkey Editor may send notifications. Notifications only come when the editor is in the background. |
| Too many notifications from the bell | set Bell to Off |
See also
SSH terminal Premium
An SSH terminal is a shell on a server, in the same Terminal window as your local tabs. It uses the connection from the Remote window, so you don't enter credentials again. Tabs, splitting, keys, links and notifications work as in the local terminal.
Where to find it
In the Remote window (⌘2):
- in the list of connections: the Terminal button when you hover over a row, or Terminal in the context menu. The shell starts in the connection's start folder.
- with an open server: Open terminal here in the header bar or in a folder's context menu. The shell starts in that folder.
How to do it
- In the Remote window, click Open terminal here.
- The editor opens a new tab in the Terminal window and connects. If the connection is not open yet, it sets it up for this.
- Work as in any shell. Drag entries from the same server's tree into the terminal and their paths on the server arrive at the prompt.
How to tell
- The tab carries the connection's name and a globe icon.
- For a connection with the colour mark red (production) the globe is red and the tab has a red edge.
- The tab's tooltip names connection and folder.
What else is different
- File paths in the output open the file on the server (Links).
- Git ▸ and Start Claude here in the server tree also run in an SSH terminal, then as an editor tab, see Server tools.
- When the session ends or the connection drops, the terminal reads “[Session on … ended or connection lost]”.
- The version badge for PHP and Node exists in local terminals only.
Free and Premium
SSH terminals are Premium, because they use the server connection from the Remote window.
Caution
You work directly on the server. Check the target and the connection before you enter commands, and keep backups at hand.
Troubleshooting
| What you see | What to do |
|---|---|
| The server allows no further session (sshd: MaxSessions). | close another terminal on this server and try again |
| The terminal could not be opened on the server. | check that the user has shell access, then reconnect |
| The server rejected the login. | check the connection's credentials, see Connections |