Guide

Terminal

Tabs, split panes, search and clickable file paths, a full terminal with a real shell in every pane.

Tabs

New tab: terminal or project? A new tab first asks where to start. Press T for a plain terminal in your home folder, O to pick a project folder, or 1–9 for a recent project. The shell starts in that folder. To skip the question, tick Don’t ask again in the dialog; turn it back on in Settings → Terminal.

Action Shortcut
New tab ⌘T
   
Close tab ⌘W
   
Reopen closed tab ⌘⇧T
   
Go to tab (search) ⌘K
or the ⌄ button after +  
Go to tab 1–9 ⌘1 … ⌘9
   
Previous / next tab ⌘⇧[ / ⌘⇧]
   
Rename tab ⌘R
or double-click the name  

Drag tabs to reorder them. A tab whose terminal is busy shows an activity pulse; closing it asks for confirmation.

Telling tabs apart: a terminal tab you haven’t renamed shows its current folder, and hovering shows the full path. Right-click a tab to give it a color. A dot appears on a tab whose output finished while you were looking at another one.

Projects: neighbouring tabs in the same git project get a project chip in front of them. Click the chip to collapse the group into one tab, and again to expand it. Sort Tabs by Project (right-click menu) brings each project’s tabs together.

Finding a tab: ⌘K opens Go to tab. Type part of a tab’s name, folder or project, then press Enter. It also shows which tabs are working and which finished.

Closing and reopening: the right-click menu has Close Others and Close Tabs to the Right, which ask once if anything is still running. ⌘⇧T reopens the last closed terminal tab in the same folder, with its name and color. It reopens the folder, not the process that was running.

Move to a new window: right-click a tab and choose Move to New Window. The shell and anything running in it keep going.

Split panes

Action Shortcut
Split side by side ⌘D
   
Split top and bottom ⌘⇧D
   
Close pane ⌘⇧W
   
Move between panes ⌘← / ⌘→
   
Zoom / unzoom pane ⌘⇧↵
   

New panes open in the same folder as the pane you split. Drag the divider to resize.

Clickable files

Any file path printed in a terminal becomes a link once the file exists. That covers the paths agents print as they work:

⏺ Write(docs/plan.md)
  ⎿  Updated src/App.tsx:42:7
Saved the report to ./out/report.pdf
  • Relative paths resolve against the terminal’s current folder, so they keep working after cd.
  • ~/… and absolute paths work too. A trailing :line or :line:col is ignored.
  • Markdown, HTML, PDFs and images open in the preview panel beside the terminal. Everything else opens in a tab.
  • A path that wraps onto the next line is still one link.
  • Words that only look like files (v1.2.3, a path that doesn’t exist) are not links.

Web addresses are links too; they open in your browser.

Press ⌘F to search the active pane. Toggle case-sensitive, whole-word and regex matching; Enter and Shift+Enter step through matches.

Recording and playback

Click REC in a pane’s corner to record its output. Stop it the same way, then open View Recordings from the command palette (⌘P ) to replay a session at 1×, 2× or 4×.

Notifications

When an agent finishes in a terminal you aren’t looking at, ADE shows a system notification and an in-app toast.

Your shell keys

On Linux, app shortcuts use Ctrl+Shift, so plain Ctrl keys always reach your shell: Ctrl+R searches history, Ctrl+W deletes a word, Ctrl+D sends end-of-file. On macOS, app shortcuts use ⌘ and Ctrl is left entirely to the terminal.