Terminal

Wrengle includes a built-in shell for working beside your notes, without leaving the app. Open it from the command palette, Voice Control, the persistent Terminal tab in the right panel's header bar, or Ctrl+`. Click the adjacent Agent tab whenever you want to go back to the assistant. Switching between Agent and Terminal keeps both your agent conversation and your running terminal sessions in place—neither one stops just because you looked away.

In the Run Terminal Command... palette mode, pressing Enter runs whatever command you've typed. Pressing Enter on an empty input does nothing, even if recent commands are showing—you have to select a recent command explicitly to run it.

When the Terminal itself is focused, Shift+Enter sends line-feed input, the same input as Ctrl+J. Programs such as Codex can use that to insert a newline without submitting the current prompt. The foreground program still decides what line feed means, so a regular shell may run the current command.

Paste text into a focused terminal with Cmd+V on macOS or Ctrl+V on Windows and Linux. On macOS, Ctrl+V also pastes. Standard paste uses the system clipboard. Text follows the terminal program's newline and bracketed paste expectations. If the clipboard contains an image, including alongside text, Wrengle forwards a Ctrl+V keypress so the foreground program can read the image from the system clipboard. Programs such as Codex that support clipboard image paste can attach it; other terminal programs decide what Ctrl+V means. This also works from the terminal's context-menu paste action.

You can also dictate into a focused, running terminal with the usual Dictate button or shortcut. Wrengle pastes each finalized phrase into the same terminal tab; it does not add Enter. Spoken paragraph breaks and other line breaks are preserved, and the foreground program decides whether they insert a new line or submit input. Dictation follows your selected cleanup setting, but it cannot revise earlier terminal input or use voice Undo to remove pasted text. If the tab closes or changes before speech settles, Wrengle holds the words in the pending-text card for you to insert elsewhere or copy. If a paste was accepted but the terminal write later fails, the same card retains the dictated phrase and warns that some input may have reached the program; inspect the terminal before trying Insert here again.

Launch profile

Terminal needs an open vault. Every new tab starts from your current vault's context and uses the per-vault profile you set in Settings → General → Terminal launch profile:

• shell path
• tab title prefix
• environment variable overrides

The shell itself is not sandboxed by Wrengle—it runs with your normal operating-system permissions. Environment overrides are local to Wrengle's terminal launch profile.

Tabs and restore

Wrengle stores terminal metadata locally, so it can restore your terminal tab layout for each vault. That metadata is a limited set of tab state—title, working directory, status, size, and timestamps. It lives in private app configuration, capped per vault, and you can clear it from the terminal metadata controls.

The terminal opens automatically once the panel becomes visible and its saved metadata is ready, unless you've suppressed terminal restore for that vault.

Appearance

Terminal background, text, muted text, borders, hover states, cursor, and selection all follow your active Wrengle theme. If a custom theme explicitly defines advanced terminal color overrides, those take precedence. The terminal follows system light and dark changes when Wrengle uses the system theme. It adjusts text colors, including ANSI colors chosen by shell programs, toward a 4.5:1 contrast ratio against their background. Some program colors may therefore look different.

Use Settings → General → Terminal font size to set terminal text from 10 to 24 px. The default is 12 px, and the setting applies to every tab.

Output, search, and links

Terminal scrollback is controlled by Settings → General → Terminal scrollback. Output continues to accumulate when you switch to Agent or hide the panel. The configured scrollback limits retained lines. A separate 512K-character limit on output awaiting rendering protects the app during very fast streams; output can be omitted before the scrollback limit is reached. Wrengle keeps up to the latest 64K unrendered characters and shows a notice when this happens. Output produced before a terminal pane is ready also has a 64K-character temporary buffer with the same notice. Terminal output is not restored after an app restart. Wrengle keeps a limited recent-command list. It also caps how much selected terminal output it captures before handing it to agent or workflow surfaces.

The terminal scrollbar is hidden. Scroll through earlier output with a wheel, trackpad, or keyboard.

Use Find in the terminal header to search current scrollback. Search shows the current match and total and highlights results. When you scroll away from live output, Jump to latest returns to the bottom and indicates when new output has arrived.

HTTP and HTTPS URLs shown in terminal output become clickable links, including URLs with Unicode characters or wrapped lines. Hover to see the full destination and its host; activation opens it through your system's browser opener. Other URL schemes and URLs with embedded credentials are ignored. Extremely long wrapped URLs are not linked so they cannot stall the terminal.

The terminal header status describes whether the shell session is running or stopped. It does not report whether a command-line agent is thinking or waiting for input.

Privacy and safety

Commands run on your machine with the same practical access as your chosen shell. Terminal output stays local app state unless you explicitly copy it, select it for an agent or workflow, or run a command that sends data somewhere else yourself.

Pasted clipboard text is sent to the foreground terminal program. For image paste, the foreground program can read the image directly from your system clipboard. It may display, store, or transmit pasted content just as it can with text you type.

Settings → General → Terminal screen reader mode is off by default. Turning it on exposes terminal output to assistive technology, which may read or retain sensitive text printed by commands. Turn it off when you no longer need this access.

Workflow terminal nodes create command drafts, not commands that run themselves. A draft only runs once you press Run in Terminal, and orchestration does not sandbox it.

Voice Control terminal run commands require confirmation before they run in your open shell. Plain dictation into the focused terminal uses the input paste path instead of that command card. Terminal input carries the same operating-system permissions and possible external side effects as anything you type directly, and voice Undo cannot reverse it.