Buy

Terminal

Free & Premium

The 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

  1. 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.
  2. ⌘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 ¾.
  3. ⌘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.
  4. 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.
  5. Reorder tabs by dragging them along the strip.

The tab

  • By default the name follows the program that is running, for example zsh or claude. 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

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

  1. In the Remote window, click Open terminal here.
  2. 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.
  3. 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

See also

Cookie preferences

This website uses cookies to ensure the best experience possible. Your choice applies to webdonkey.io and the shop at shop.webdonkey.io. More information...

Technically required

Cookies required for this website to function:

Always on
WebDonkey
WebDonkey
Provider: BuI Hinsche GmbH, Neumarkt 7, 06712 Zeitz, Germany
Purpose: Your consent, colour scheme and language for website and shop, price switches; with wd_debug in the address, the measurement events in the developer console for troubleshooting
Cookies and storage: Cookie wd_consent on .webdonkey.io, shared with shop.webdonkey.io (12 months); cookies wd_theme and wd_lang on .webdonkey.io, shared with shop.webdonkey.io, only when you switch colour scheme or language yourself (365 days); localStorage wd:consent, wd:theme, wd:lang; sessionStorage wd:acc, wd:term, wd:debug (only with wd_debug in the address; until the tab closes)

Statistics

Shows us which pages and products people look at on webdonkey.io and in the shop, where visitors come from and how they get to a purchase (with order number, amount and products, without name or email address). Provider: Google. Transfer to the USA possible (EU-US Data Privacy Framework). Your choice applies to webdonkey.io and the shop together.

Google Tag Manager, Google Analytics 4
Google Tag Manager
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Loads the services you agreed to, here and in the shop. Sets no cookies of its own.
Cookies and storage: none
Privacy policy
Google Analytics 4
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Usage statistics: page views, clicks, scroll depth, sources, devices, load times; in the shop also basket, checkout, purchases, registration and sign-in
Cookies and storage: _ga, _ga_<ID> (2 years)
Privacy policy

Marketing

Measures whether our ads on Facebook, Instagram and TikTok lead to visits and downloads on webdonkey.io and to registrations and purchases in the shop, and builds audiences for ads. Providers: Meta and TikTok, with whom we are jointly responsible for this. With this consent Google may also set advertising cookies (_gcl_…). Transfer to the USA and other countries outside the EU possible. Your choice applies to webdonkey.io and the shop together.

Google Tag Manager, Meta Pixel (Facebook, Instagram), TikTok Pixel
Google Tag Manager
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Loads the services you agreed to, here and in the shop. Sets no cookies of its own.
Cookies and storage: none
Privacy policy
Meta Pixel (Facebook, Instagram)
Provider: Meta Platforms Ireland Limited, Merrion Road, Dublin 4, D04 X2K5, Ireland
Purpose: Ad measurement and target groups on Facebook and Instagram, also in the shop (basket, checkout, purchases, registration)
Cookies and storage: _fbp (3 months), _fbc (3 months, only if you arrive through an ad), fr on facebook.com (3 months)
Privacy policy
TikTok Pixel
Provider: TikTok Technology Limited, 10 Earlsfort Terrace, Dublin, D02 T380, Ireland
Purpose: Ad measurement and target groups on TikTok, also in the shop (basket, checkout, purchases, registration)
Cookies and storage: _ttp, _tt_enable_cookie (13 months)
Privacy policy