# 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, use terminal controls and agent context pins, and report program status with OSC 7501.

## Pages

- [Terminal basics](/api/v1/docs/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](/api/v1/docs/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](/api/v1/docs/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](/api/v1/docs/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](/api/v1/docs/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](/api/v1/docs/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](/api/v1/docs/terminal/search) - 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](/api/v1/docs/terminal/reattach) - Solo keeps terminal views current automatically when you switch processes, return to a terminal, or reopen a project view. You don't need to refresh a terminal by hand.
- [Follow output and jumping to bottom](/api/v1/docs/terminal/pause-resume) - 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](/api/v1/docs/terminal/persistent-sessions) - 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](/api/v1/docs/terminal/context-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](/api/v1/docs/terminal/osc-kitty-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…
- [Program status protocol (OSC 7501)](/api/v1/docs/terminal/program-status) - Programs running in Solo can report what they're doing with OSC 7501, the program status protocol: working, blocked on you, done, failed, or idle. Solo uses those reports to drive…

---

Are you a human? Read this doc on the web: https://soloterm.com/docs/terminal