Docs/The Director/The terminal tab
Director

The embedded terminal

3 min read

Every session in the Director carries a real terminal - the same one the coding agent is running in. The Terminal tab shows it live: you watch the agent work, scroll back through what it did, and, when you want to, type straight into it. Next to it sits the Source Control tab.

The prompt bar

Below the terminal is the prompt bar - a separate box that lives outside the terminal, so you can compose slowly (or dictate) without your keystrokes going anywhere until you decide:

  • Send (Ctrl+Enter) - send the message into the terminal.
  • Queue (Ctrl+Shift+Enter) - park it in the queue instead of sending it now; it waits there until you send it.
  • Speak (Ctrl+H) - dictate instead of typing; see Voice.
  • An Expand button opens a larger editor - handy for long prompts, with image previews for anything you dragged in.
  • Typing / pops up slash-command autocomplete with descriptions.

Because the prompt bar is its own surface, it can also be driven remotely - the same box answers from your browser and phone.

Working inside the terminal

  • Select text by dragging; Ctrl+C copies when text is selected (and sends the usual interrupt when nothing is). Ctrl+Shift+C copies the selection and never interrupts - with nothing selected it does nothing. Ctrl+V pastes, and right-click offers Paste.
  • Links the agent prints are detected - click one and a small menu offers open or copy.
  • Arrows, function keys, and the control strokes a CLI leans on - Ctrl+C, Ctrl+D, Ctrl+Z and Ctrl+L - pass straight through.

When the display needs a nudge

Terminals are stateful, and after a lot of fast output the picture can occasionally drift from reality. Reset View above the terminal (Reset Terminal View in the View menu) rebuilds the display from the underlying buffer. Capture (Ctrl+Shift+F12) writes a diagnostic snapshot to a file - useful when reporting a display problem.

Tip
You rarely need to type in the terminal itself. The prompt bar is the intended way to talk to an agent - the terminal is primarily your window into what it is doing.
Note
Sessions live inside the Director, so closing the window ends them - and do not count on a warning. The confirmation dialog appears only for sessions that are actively working or waiting for your answer; one that is starting up, idle, or waiting on a permission closes without it. Minimise the window instead; see keeping agents running.