Terminal Usage

Braide includes an embedded terminal powered by xterm.js, giving you command-line access alongside your agent sessions.

Opening the Terminal

Select or create a session
Click the terminal toggle button in the prompt input area
The terminal panel appears below the session content

Each session has its own independent terminal instance.

The embedded terminal panel below the session content

Using the Terminal

The terminal provides a full shell environment:

Run any commands available in your system shell
The working directory is set to the session's worktree — an isolated git working copy unique to this session (not the project root). See Worktrees for details.
Command history and standard shell features are available
Output is displayed in real time

Resizing

The terminal panel can be resized by dragging:

Hover over the divider between the session content and the terminal
Click and drag up or down to adjust the height
The height is saved per-session and restored when you reopen the terminal

Toolbar

The vertical toolbar on the left edge of the terminal provides quick actions:

Close (red square) — Terminates the shell process and closes the panel
Search (magnifying glass) — Opens the find-in-terminal bar (also available via ⌘F / Ctrl+F)
Clear (trash icon) — Clears the visible terminal output and the server-side scrollback buffer
Copy (clipboard icon) — Copies the entire terminal buffer to the clipboard; shows a brief checkmark when complete
Restart (appears only when the process has exited) — Spawns a new shell session

Keyboard Shortcuts

While the terminal has focus:

Shortcut	Action
`⌘A` / `Ctrl+A`	Select all terminal content
`⌘C` / `Ctrl+C`	Copy selected text (sends SIGINT if nothing is selected)
`⌘F` / `Ctrl+F`	Open find-in-terminal search bar
`Escape`	Close the search bar

Terminal States

Open — Terminal is visible and connected
Closed — Terminal is hidden but the process may still be running
Exited — The shell process has ended; the terminal shows "[Process exited]"

Reviving a Terminal

If a terminal connection is lost (e.g., after a page refresh), Braide can revive it. The terminal process continues running in the background, and reconnecting restores the session.

Closing

Click the terminal toggle button again to close the terminal panel. You can also fully close the terminal connection from the terminal's close button, which terminates the shell process.