Window layout
FreeA WebDonkey Editor project window consists of the code area in the middle and the tool windows around it: Project, Git, Terminal, Claude, Database and all the others. Every tool window has an icon in a narrow stripe at the left or right edge. Clicking it shows or hides the window. The title bar with the project menu sits on top, the status bar at the bottom. You decide how the tools are arranged, and the editor remembers it.
What you do here
- Stripes and icons: open and close tool windows, use their shortcuts, switch tools off
- Places and window types: move tools, open them as a tab or as a window of their own
- Sizes and maximizing: drag dividers, let them snap, hide everything
- What the editor remembers: what applies to you and what per project
- Start screen: what you see while no project is open
- Projects and windows: the project menu, one window per project, closing and quitting
- Menus: the menu bar, the title bar buttons and right-clicking text
- Status bar: branch, site, cursor, encoding and what clicking them does
Parts of the window
| Part | What is there |
|---|---|
| Title bar | the project menu with the project name on the left, a search field for Search everywhere in the middle, the launcher bar, the WebDonkey button and the Free notice on the right |
| Stripes | one stripe on each side with the icons of the tool windows |
| Tool windows | left, right and at the bottom, up to two per side, stacked or side by side |
| Code area | your tabs, split as often as you like (Tabs, Splits) |
| Status bar | branch, WebDonkey and site, cursor, indentation, line endings, encoding and language of the active file |
Out of the box
| Place | Tools |
|---|---|
| Left top | Project |
| Left, below | Remote, Git, Notes |
| Right top | Claude, MCP, WebDonkey, Database, AI |
| Right, below | |
| Bottom left | Terminal, Mission Control, Find, Problems & Output, Git Graph |
| Bottom right | Launcher |
A project you open for the first time shows Project and Terminal. While no tab is open, the terminal takes up the whole code area. The first tab that opens sends it back to its place at the bottom. You can switch this off under Terminal in the settings: Terminal fills the editor area when no tab is open.
Tip: Esc takes you from a tool window back to the code. Not in the terminal: there, Esc belongs to the program that is running.
Free and Premium
The window layout is free. The Remote and Notes tool windows are part of WebDonkey Premium. Without Premium they show the notice "This tool window is part of WebDonkey Premium." and the link See Premium instead of their content. Prices are on webdonkey.io/pricing.
Stripes and icons Free
To the left and right of the code area there is a narrow stripe of icons. Each icon belongs to a tool window. One click opens the window at its place, a second click hides it again. The stripes, their shortcuts and the settings decide which tools you see.
Where to find it
The stripes are always there, even without an open project. Hovering an icon shows the tool's name and, if it has one, its shortcut.
How to do it
- Click an icon, for example Git. The tool window opens at its place and the icon is highlighted.
- Work in the window. Esc takes you back to the code.
- Click the icon again or press its shortcut to hide the window.
How a stripe is built
Each stripe has up to four groups, separated by thin lines:
| Group | Where it opens |
|---|---|
| top | in the upper half of this side (left out of the box: Project) |
| below | in the lower half of this side (left out of the box: Remote, Git, Notes) |
| at the foot | also in the lower half; the group sits at the bottom of the stripe and grows upwards |
| at the very bottom, below the line | in the bottom dock: the left stripe shows its left half, the right stripe its right half |
An empty group is invisible. It only appears, as a dashed spot to drop onto, while you drag an icon (Places and window types).
What an icon tells you
- Highlighted: the tool is open right now.
- Small dot at the bottom right: the tool lives as a tab in the code area or in a window of its own. Clicking brings that tab or window to the front.
- Mission Control opens as a tab on every click, whichever group its icon sits in.
Tool window shortcuts
| Tool | Shortcut |
|---|---|
| Project | ⌘1 |
| Remote | ⌘2 |
| Claude | ⌘3 |
| WebDonkey | ⌘4 |
| Database | ⌘5 |
| Problems & Output | ⌘6 |
| MCP | ⌘7 |
| Git | ⌘9 |
| Terminal | ⌥F12 |
| AI | ⇧⌘I |
These shortcuts also work while the focus is in the terminal, so ⌥F12 hides the terminal from inside it. Mission Control, Git Graph, Find, Mail, Notes and Launcher have no shortcut of their own. ⇧⌘F opens Find in files in the Find window.
Other ways to reach every tool:
- View › Tool Windows in the menu bar: all tools, the visible ones with a check mark (Menus)
- Command palette (⌘K): commands such as Show/hide Git
- Search everywhere (⇧⇧): the Tools category
Switching tools off
What you never need, you switch off under Settings › Features, group Tool windows. Hidden means: not loaded, no icon in the stripe, no shortcut, no menu entry. This works for every tool except Project. If you switch off a tool that is open, it disappears at once from its place and from the code area. A window of its own then only shows the notice "… is hidden in the settings." See Features.
Free and Premium
Remote and Notes are part of WebDonkey Premium. Their icons stay in the stripe without Premium; the window then shows a notice with See Premium. When the editor runs without WebDonkey, there is also Enter license key: you enter your Premium key right in the editor, you don't need WebDonkey itself for that.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| An icon is missing | the tool is switched off under Settings › Features | switch it back on there |
| A shortcut does nothing | the tool is switched off, or a dialog covers the window | check the setting, close the dialog |
| A window says "… is hidden in the settings." | it was switched off while it was open | Open settings and switch it on |
See also
Places and window types Free
Every tool has a fixed place: a side (left, right or bottom) and a half of that side. You change the place by dragging or through a menu. Independently of that, a tool can appear in three ways: docked at the edge, as a tab between your files, or as a macOS window of its own, for example on a second display.
Where to find it
- Place: right-click an icon in the stripe
- Window type: the ⋯ button (Options) in the header of a tool window, or right-click the header
How to do it
Moving an icon
- Pick up the icon in the stripe and drag it into another group or between two icons. A line marks the spot; empty groups appear as dashed spots.
- Let go. The tool now lives there and opens in that half from now on. If it was open, it stays open, just at its new place.
Without dragging, use right-click on the icon › Move to:
| Entry | Place |
|---|---|
| Left top (side) | upper half, left |
| Left, below (side) | lower half, left |
| Left bottom (side) | lower half, left, icon at the foot of the stripe |
| Right top (side), Right, below (side), Right bottom (side) | the same on the right |
| Bottom dock, left | left half of the bottom dock, icon at the bottom of the left stripe |
| Bottom dock, right | right half of the bottom dock, icon at the bottom of the right stripe |
The current place has a check mark. Reset all icons to default in the same menu restores the original arrangement. The entry is greyed out as long as you haven't moved anything.
The place applies to all projects and all windows. Put Project on the right and it is on the right in every project, including windows that are open right now.
Opening a tool as a tab or a window of its own
- Click ⋯ in the header of the tool window.
- Choose Open as tab or Open in own window.
Dragging the header of the tool window is quicker:
- into the middle of an editor group: the tool becomes a tab there
- onto the edge of an editor group: it opens as a tab in a new split
- out of the editor window: it becomes a window of its own
- onto a group in a stripe: it gets its new place there
It comes back to the edge when you close its tab or its window. The tab's context menu has Back to its side for this, and a window of its own has a button of the same name in its title bar. The tool then docks at its place and is open there.
The menu in a tool window's header
The header has two buttons: ⋯ (Options) and a bar (Hide). The Options menu (also on right-click on the header):
| Entry | What it does |
|---|---|
| Refresh | resets the window to how it looked when first opened and reads everything anew; only for tools that offer it, currently the Claude window |
| Hide | hides the window, with its shortcut next to it |
| Dock left, Dock bottom, Dock right | moves the tool to another side, same half; the current side has a check mark |
| Move to lower/right half or Move to upper/left half | switches the half on the same side |
| Open as tab | opens the tool as a tab in the code area |
| Open in own window | opens it as a macOS window of its own |
| Size: Half, Third, Quarter | sets the width or height of the side |
| Maximize or Restore (⇧⌘') | see Sizes and maximizing |
Two windows per side
Each side has two halves. Each can show one tool, for example Project above and Git below it. Opening another tool of the same half replaces the one shown there. You drag the divider between the two with the mouse.
Window types at a glance
| Type | Behavior |
|---|---|
| Docked | sits at the edge, shown and hidden with its icon or shortcut |
| Tab | lives as a tab in the code area and can be moved and split like any tab |
| Own window | a macOS window of its own, with the tool's and the project's name in the title; it belongs to the project window it came from |
Exceptions:
- Mission Control always opens as a tab and can't be docked, so its Options menu has no docking entries. You can still move its icon.
- Notes never becomes a window of its own. Open in own window is missing there; to work with Notes at full size, open it as a tab.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| After a restart a tool is docked again | own windows don't survive a restart | choose Open in own window again |
| Reset all icons to default is greyed out | you haven't moved anything yet | nothing to do |
| A tool opens somewhere else than expected | you moved its icon in another window; the place applies everywhere | drag the icon back or Reset all icons to default |
See also
Sizes and maximizing Free
The tool windows at the sides and at the bottom have a size you set by dragging or through a menu. Two shortcuts bring one tool up big or clear everything away except the code.
How to do it
- Grab the edge between the code area and the tool window with the mouse.
- Drag it to the size you want. Near ¼, ⅓, ½, ⅔ and ¾ it snaps.
- A double-click on the edge switches between ½ and the size you had last.
The same works for the divider between two tool windows of one side and for the splits in the code area.
Size from the menu
The ⋯ menu of a tool window (or a right-click on its header) has Size: Half, Third, Quarter. This sets the whole side the tool sits on.
Fractions, not pixels
Sizes are fractions of the window, not pixels. A quarter stays a quarter when you make the window bigger or smaller. A tool area takes at least 8 % and at most 85 %.
| Area | Starting value |
|---|---|
| left | 20 % |
| right | 24 % |
| bottom | 32 % |
| divider between two tools of a side | ½ |
Maximize and hide everything
| Shortcut | Command | What happens |
|---|---|---|
| ⇧⌘' | Maximize tool window | The tools of the side the last used tool window sits on fill the whole area between the stripes. If none had the focus yet, it is the bottom dock. The same shortcut restores the view. |
| ⇧⌘F12 | Hide all tool windows | everything on the left, right and bottom is hidden, only the code stays |
Both shortcuts also work while the focus is in the terminal. Both are in the View menu.
Narrow windows
When the area between the stripes is narrower than 1000 pixels, the side tool windows no longer push the code area aside but lie on top of it. A click into the code area hides them. Mission Control stays usable next to them as long as there is room left.
Terminal without open tabs
When no tab is open and the terminal is docked and visible, it takes up the whole code area. Its saved size does not change: as soon as a tab opens, it goes back to its usual size. Switch this off under Settings › Terminal: Terminal fills the editor area when no tab is open.
See also
What the editor remembers Free
The editor restores every project the way you left it: open tabs, splits, tool windows and their sizes. Some things apply to you as a whole instead, whichever project is open. This page shows what goes where and where it is stored.
For all projects and windows
- the place of every tool: side, half and order in the stripe. When you move an icon, it applies at once to every other open project window too.
- the editor settings, such as font, minimap or word wrap
- the list of recently opened projects
Per project
- which tools are open and whether they are docked or live as a tab
- the sizes of the sides and dividers
- what a tool showed last: the repository picked in the Git window, a filter, collapsed sections, the selected row. Close a tool and open it again, restart the editor or move the tool into a window of its own, and it looks the same.
- the open tabs, the splits of the code area and the cursor position in your files
- attached folders and subprojects
- the state of the project tree
Where it is stored
A project's state lives in the project folder in .webdonkey-editor/workspace.json. File paths in it are stored relative to the project. Move or rename the project folder and everything is kept.
When the editor creates the .webdonkey-editor folder, it writes a .gitignore with * into it. Git therefore ignores the folder, and your project's own .gitignore stays untouched. If nothing can be written in the project folder, the editor keeps the state with itself instead.
After a restart
- A tool that was a window of its own when you quit comes back docked. The window itself doesn't survive the restart.
- Tools you switched off in the settings stay off.
- If a tool has a different place by now, it stays open, just there.
- If Reopen the projects that were open last is on (Settings › Features, group Start), your last projects open again. Otherwise the editor starts with the start screen.
Tip: To get the icons back in their original order, use Reset all icons to default in the right-click menu of an icon. The state of your projects stays as it is.
See also
Start screen Free
When a window has no project open, the editor shows its start screen: WebDonkey Editor, "The workplace next to WebDonkey." From here you open a folder, clone a repository or jump into a project you had recently.
Where to find it
The start screen appears on the very first start, on every start while Reopen the projects that were open last is off, and when you choose Close project in the last open window.
How to do it
- Click Open folder… (or press ⌘O) and pick your project folder.
- Or click a project in the Recent projects list.
If that project is already open in another window, the editor brings that window to the front instead of opening it twice.
What you find there
| Element | What it does |
|---|---|
| Open folder… | opens a folder as a project, like ⌘O |
| Clone repository… | brings a Git repository to your Mac, see Clone a repository |
| Recent projects | your last twelve projects with name and path; until there is one, it says "Nothing open yet" |
| From WebDonkey | your sites with domain and project folder; a click opens the site's project folder as a project |
From WebDonkey only appears when the editor is connected to WebDonkey and there are sites.
When the editor can't use WebDonkey, a notice sits at the top. Usually WebDonkey is older than this editor needs, and the notice asks you to update WebDonkey. Otherwise it says what works without it: "Editor, files, terminal and git work. Remote, database and themes unlock with WebDonkey."
Settings
| Setting | Where | Default |
|---|---|---|
| Reopen the projects that were open last | Settings › Features, group Start; off: the editor starts with the start screen | on |
| Sites from WebDonkey on the start screen | Settings › Features, group Start | on |
| Color gradient on the start screen | Settings › Appearance | on |
See also
Projects and windows Free
Every project has its own editor window. You open, switch and close projects through the project menu on the left of the title bar. A project is never open twice: open one that already has a window, and that window comes to the front.
Where to find it
Click the project name on the left of the title bar (without a project: No project open). The same projects are in File › Recent projects in the menu bar.
How to do it
Opening another project
- In the project menu, click Open folder… or a project under Recent projects.
- If the window already has a project, a dialog titled Open “Name” appears with these buttons:
| Button | What happens |
|---|---|
| New window | The folder gets a window of its own, the current project stays where it is. This is the default. |
| This window | The current project closes here and the folder opens in its place. The editor asks about unsaved files first. |
| Attach | The folder joins the same project as another folder, see Multiple folders. |
| Cancel | Nothing happens. |
Closing a project
- In the project menu choose Close project (also in the File menu).
- The editor asks “Close project “Name”?”. If you have unsaved files, it asks whether to save them instead.
- Confirm with Close project.
If other project windows are open, this window closes. If it is the last one, it stays open and shows the start screen.
The project menu
| Entry | What it does |
|---|---|
| Open folder… | picks a folder as a project |
| Clone repository… | clones a Git repository, see Clone a repository |
| Recent projects | the last ten projects; a click opens one, the current one has a check mark |
| Rename combination… | only with attached folders: gives the combination a name of its own |
| Detach from project: folder | only with attached folders: takes that folder out again, nothing is deleted on disk |
| Close project | closes this window's project |
In the Recent projects list:
- A green dot shows that the project is open in a window right now.
- Close window (window icon at the right of the row, only for open projects) closes that project's window, with the same questions as above.
- Remove from list (list icon at the right of the row) asks right in the row: "Remove?" with Yes and No. For an open project the question is "Close and remove project?": the project closes first and then leaves the list. Nothing is deleted on disk.
- If the entry belongs to another window, the menu stays open after these actions.
- Long names wrap. A combination with a name of its own is shown in colour, its folders below it.
The field for renaming is called Name (empty = project names). Leave it empty and the combination is named after its folders again.
Folders you mark with Show as subproject in the project tree (Subprojects) are not in the project menu. They appear in Mission Control as projects of their own, with their own sessions.
Windows and their titles
Every project window carries its project's name in the window title; with attached folders, all folder names joined with "+", or the combination's name. If two projects have the same name, the parent folder is put in front. Tool windows you detached into a window of their own belong to the project window they came from (Places and window types). Requests from outside, such as wd edit from the terminal, go to the window whose project the file belongs to.
Closing a window
Clicking the red button of a project window asks “Close the window of “Name”?”. Idle terminals are closed. Programs still running in them keep running and are back when you open the project again.
If it is the last window, it depends on Keep running when the window is closed (Settings › Features, group App, on out of the box):
- on: The project stays open and the editor keeps running in the Dock. Terminals and Claude sessions keep going. A click on the Dock icon or
wd editbrings the window back. - off: The editor quits afterwards. The question names the programs that will end.
Quitting
⌘Q (Quit WebDonkey Editor) quits the editor with all its windows. First it saves what autosave would save anyway, then it asks, one after the other:
- about unsaved files: Save, Don't save or Cancel
- about programs still running in terminals (such as Claude or a dev server) and operations still running on a server (Backup, Sync, Restore, Upload, Download): Quit or Cancel
The same questions come when you quit from the Dock or log out. If a window doesn't answer within a few seconds, the editor quits anyway, so it can never get stuck.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| A project doesn't open in the current window, another window comes to the front instead | the project is already open there | work there or close that window |
| The editor keeps running after you close the last window | Keep running when the window is closed is on | quit with ⌘Q or switch the setting off |
| ⌘Q doesn't quit right away | there are unsaved files, running programs or server operations | answer the questions |
See also
Status bar Free
The status bar at the bottom of the window shows where you are at a glance: branch, site and PHP version, updates, AI and Claude, who last changed the current line, and the key facts of the active file. Almost every entry is a button that opens the matching tool or a menu.
Where to find it
The status bar is at the bottom of every project window. Entries with nothing to say are left out: no branch without a Git repository, no file details without an open file.
The entries from left to right
| Entry | What it shows | A click |
|---|---|---|
| Git branch | the project's branch with a branch icon | opens the Git window |
| WebDonkey and site | a dot (green: WebDonkey is running), the domain of the project's site and its PHP version, then the number of running services. Without a matching site it reads WebDonkey or "WebDonkey not running". Only when the editor is connected to WebDonkey. | opens the WebDonkey window |
| Open in browser | appears when the project belongs to a site and WebDonkey is running | opens the site in your default browser |
| Service dots | one dot per service of the site, green, red or pulsing yellow while starting | opens a menu to start, stop and restart, see Status bar in the WebDonkey chapter |
| Update | Update version when a new editor version is waiting | opens Changelog & Updates |
| AI | whether suggestions while typing are on, off or paused; struck through means off | opens a menu (see below) |
| Claude | ✳ and your Claude limits: the share of the 5-hour window and, after W, of the week, in the warning colour from 80 %. A dot in front means a Claude session is connected to this editor. | opens the Claude window |
| Who changed the line | author and age of the last change to the cursor's line, such as "Alex, 2 days ago"; "Not committed yet" for new lines. The tooltip names the commit and its message. | nothing |
| Line:Column | the cursor position, with the selection in brackets after it, such as "(12 chars)" or "(120 chars, 4 lines)" | nothing |
| Indentation | 4 spaces or Tabs | nothing |
| Line endings | LF or CRLF | switches, see Encoding, line endings and language |
| Encoding | for example UTF-8 or ISO-8859-1 | menu with Reopen with encoding and Save with encoding |
| Language | the language mode, such as PHP or Twig | list of all languages with a search |
| Free | shown as long as you don't have WebDonkey Premium | nothing |
Cursor, indentation, line endings, encoding and language only appear while a file or a comparison is in front. Out of the box, the editor also shows who last changed a line faintly behind the cursor's line; you switch that off under Settings › Editor with Git blame in the line. The editor reads the Claude limits from Claude Code's status line, which costs no tokens. They appear as soon as WebDonkey has a value.
The AI menu
Clicking AI opens:
| Entry | What it does |
|---|---|
| Suggestions while typing | switches the local AI's suggestions on or off everywhere |
| In this project | switches them off or back on for this project only |
| Download with the model's name, or Load a model in WebDonkey | appears when there is no model for suggestions yet |
| Show/hide AI | opens the AI window |
The tooltip names the model, the median response time and how many suggestions you took. The editor counts these on your Mac only. When the battery drops below 20 %, suggestions pause, as long as the matching setting is on (on out of the box). More under Suggestions while typing.
Switching entries off
Under Settings › Features, group Status bar, you switch each entry off on its own. All are on out of the box.
| Switch | Entry |
|---|---|
| Git branch | Git branch |
| WebDonkey and the project's site | WebDonkey and site |
| Open in browser | Open in browser |
| Update notice | Update |
| AI ghost text | AI |
| Claude | Claude limits |
| Who last changed the line | author and age of the line |
| Cursor, language and indentation | Line:Column, indentation, line endings, encoding, language |
| Free notice | Free |
You switch the service dots off under Settings › Services with The site's services in the status bar. If the AI tool is switched off, its entry disappears as well.
Free and Premium
The status bar is free. Suggestions while typing are part of WebDonkey Premium: without Premium the AI entry shows a lock and its menu says "Suggestions while typing are part of Premium." In the service dots' menu, the entry for following the log reads Follow log (Premium, opens WebDonkey) without Premium.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| No branch | the project isn't a Git repository, or Git isn't installed | create a repository or install Git |
| No site, just WebDonkey | the project folder belongs to no site in WebDonkey | open the site's folder, see Sites |
| No Claude limits | WebDonkey has no value from Claude Code yet, or the editor runs without WebDonkey | start a Claude session |
| No author for the line | the file isn't in a repository | nothing to do |
| No file details | what's in front is no text but a tool, an image or another viewer | bring a text file to the front |