Within each project in the sidebar, items are organized into sections — named groups that categorize what kind of item each row is.
Common section types
| Section | Icon | Contents |
|---|---|---|
| Todos | Checkbox | Active todos for the project |
| Agents | Robot/sparkle | AI agent tabs (Claude Code, Gemini CLI, Codex CLI, etc.) |
| Terminals | Shell prompt | Interactive terminal sessions |
| Commands | Stack/play | Shell commands — dev servers, build scripts, workers, etc. |
| Scratchpads | File | Project notes and scratchpads |
Todos and Scratchpads can be shown or hidden from Settings -> Notes & todos. Agents, Terminals, and Commands stay available as process sections.
Section headers
Each section has a header row displaying:
- Chevron — collapses or expands the section.
- Section name and icon.
- Count on the right side. Todos and Scratchpads show a single item count; Agents, Terminals, and Commands show running / total.
When section decorations are disabled, the separator line and counts are hidden. When project hotkey hints are active, Solo can temporarily show a section jump hotkey instead of the count for Agents, Terminals, and Commands.
Section headers don't contain bulk start/stop or add buttons.
Empty sections
By default, Solo shows built-in sections even when they're empty. Settings -> Sidebar includes per-section empty-section controls for Todos, Agents, Terminals, Commands, and Scratchpads.
When an empty section is visible, Solo renders an inline add row inside the section body when that section supports creation.
Count display
Todo headers count the active todos included in the project's sidebar model, and Scratchpad headers count the unarchived scratchpads included there. Either count can be larger than the inline preview because its configured preview limit and collapsed state do not change the header count.
For Agents, Terminals, and Commands, the running number counts every live running process of that section kind in the project before the current sidebar text filter is applied. It can therefore include matching-kind processes that the filter has withheld from the rows.
The total is the current section-model count, not necessarily the number of rows presently drawn. An Agents total can include descendants hidden under a collapsed agent, a Terminals total remains when the section is collapsed, and a Commands total can include stopped lesser-used commands that are currently hidden.
Section order
Section order is remembered per project. You can drag section headers to rearrange them. The canonical default order is Todos -> Agents -> Terminals -> Commands -> Scratchpads, adjusted by your visibility settings and any per-project order you have saved.
See Reordering sections for details.
Selecting and collapsing
- Click the label area to select a section header.
- Click the chevron (▸ or ▾) on the left to toggle collapse without changing selection.
Selecting a section header opens its section overview, with the items and actions for that section.
See Collapsing and expanding sections for all the ways to collapse.