Terminals

A terminal pane is a real pseudo-TTY on the canvas. It runs your shell with your environment, profile, and the active space's project folder as its working directory.

Spawn one with Cmd+4Ctrl+4 or choose Terminal from the spawn menu.

What you get

• Interactive shells and TUIs through node-pty and xterm.js.
• ANSI color, scrollback search, web links, resizing, and serialization.
• Your normal shell environment and dotfiles.
• The same terminal surface used by interactive harness panes.

Input and paste

Standard terminal chords such as Ctrl+CCtrl+C, Ctrl+DCtrl+D, Ctrl+LCtrl+L, and Ctrl+RCtrl+R pass through to the PTY.

On Windows and Linux, Ctrl+VCtrl+V pastes directly; you do not need Ctrl+Shift+V. AgentGrid sends clipboard text as sanitized bracketed paste, preventing multiline content copied from a webpage from running automatically.

When the clipboard contains an image:

• A harness with direct image input, such as Claude Code, receives the actual image attachment.
• Other terminal-backed panes receive the path to a temporary image file so the CLI can open it.

Search and multiline prompts

Press Cmd+FCtrl+F in a terminal-backed pane to search its scrollback. Enter selects the next match, Shift+Enter selects the previous match, and Esc closes search.

Shift+EnterShift+Enter uses the selected harness's newline behavior. In Claude Code panes, AgentGrid sends the CLI-specific escape sequence for a newline without submitting the prompt.

Use Cmd+KCtrl+K to clear the visible scrollback without sending a command to the shell. Hold CmdCtrl and click a detected URL to open it in the system browser.

macOS line movement

AgentGrid translates familiar macOS chords:

Windows and Linux use their physical Home, End, PageUp, and PageDown keys.

Terminal scrolling and canvas navigation

Normal scrolling belongs to the terminal. To pan the canvas from over the terminal, hold OptionCtrl and drag, middle-click, or scroll. Pinch zoom and Cmd+ScrollCtrl+Scroll zoom the canvas from under the cursor.

Space is never captured for canvas pan, so it remains ordinary terminal input.

Terminals started by an orchestrator

A master or worker can start a visible long-running terminal for a dev server, database, or watcher. The owner can read incremental output, wait for a readiness pattern, and discover a reported development URL while you continue to use the same pane.

Orchestrator-created terminals are parented to the pane that started them and close automatically with that owner.

Related

• Coding harnesses - AI CLIs that share the terminal surface.
• Orchestrating agents - workers and long-running processes.
• Keyboard shortcuts - the full binding reference.