Terminal
Terminals are blank shell sessions inside a Solo project. Use them for ad hoc commands, debugging, package installs, one-off scripts, or anything that should stay near the rest of your project workspace without becoming a managed command.
Terminal basics
The terminal pane on the right side of Solo displays the output of whichever command is selected in the sidebar. It's a full-featured terminal emulator, not just a log viewer.
Terminal control bar
The bar along the bottom of the terminal pane shows the selected process's status and resource usage, and gives you one-click access to focus, navigation, and process controls 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 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
Right-clicking anywhere in the terminal pane opens a context menu with actions for the current terminal. It uses native system menus, so it looks and behaves like the system menu i…
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