Terminal

The terminal pane is Solo’s shared process surface for commands, agents, and shell sessions. Learn how keyboard and mouse input behave, search terminal output, reattach or resume sessions, and use terminal controls and agent context pins.

Terminal basics
The terminal pane on the right side of Solo is where you view and interact with the selected process. Commands, agents, and terminals all use the same full-featured terminal emulat…
Terminal control bar
The bar along the bottom of the terminal pane shows the selected process's status. After resource statistics become available for a running process, it also shows resource usage an…
Terminal context pins
Context pins are the small status overlays in the top-right corner of an agent terminal. They keep locked todos, saved-session details, and Solo MCP setup health close at hand with…
Terminal keyboard input
When the terminal is focused, Solo encodes your keystrokes and sends them to the running process, the same way a standalone terminal would. This page covers how keys are routed, th…
Terminal mouse ownership
When a running terminal application turns on mouse reporting, Solo shows a control in the top-right corner of the terminal. Use it to decide whether pointer gestures control the ap…
Terminal focus behavior
Solo tracks whether keyboard input belongs to the sidebar or the terminal. This matters because printable keys are sent to the running process only while terminal focus is active.
Searching terminal output
Solo has a built-in find bar for searching through a command's terminal output. It's useful for locating specific error messages, log lines, or any text buried in the scrollback bu…
Terminal reattach behavior
Solo keeps terminal views current automatically when you switch processes, return to a terminal, or reopen a project view. There is no separate refresh button or menu item.
Follow output and jumping to bottom
When a command is producing output fast, new lines can push earlier content out of view. Solo uses follow mode to decide whether the view stays pinned to live output or preserves y…
Terminal session persistence
Solo keeps process definitions in local state and keeps terminal output/history for the lifetime of the running process. The terminal pane can detach and reattach to a running proc…
Terminal right-click menu
When terminal mouse reporting is off, right-clicking anywhere in the terminal pane opens a context menu with actions for the current terminal. It uses native system menus, so it lo…
OSC, links, and Kitty keyboard protocol
Solo supports common OSC (Operating System Command) sequences and Kitty protocol features used by modern terminal apps. If you're building or using TUI tools, these are the protoco…

Are you an agent? Read this doc via API: /api/v1/docs/terminal