Pick a layout
Settings › Appearance › Tabs and sessions sets where sessions and tabs show. Three presets set everything at once:
After a preset, each option can change: where sessions live, what the title bar shows, how a state looks (icon, dot or word), grouping by project, projects with nothing running, long titles and the sidebar width.
A state file from before this setting opens on Classic, so your window doesn’t change after an update. Pick Focused to switch.
Read the sidebar
With Focused, the sidebar lists every session of every project, under its project. Each row has a mark for its state:
The end of the row says what wants you, or the number of the pull request.
A project with nothing running folds. The project on screen and any project with a session that works or needs you stay open. Click a project to fold or open it. Settings can keep such projects open or hide them.
Archived sessions stay out of the list. The archived toggle shows them.
Pin sessions to the title bar
With sessions in the sidebar, the title bar holds the sessions pinned to it, from any project, plus the tab on screen and pages, files and views.- Drag a row up to the bar. A line marks where it lands.
- Or pick Pin to the title bar in the row’s right-click menu.
- Or press Alt+P while the pointer is on the row. On the bar, Alt+P pins or unpins the tab on screen.
See what needs you
The Active list at the top of the sidebar shows the sessions of every project that need you, because they wait for an answer or failed, then the ones that run. A click opens the session in its project. Move or remove the list from Customize › Sidebar. An environment needs you when:- a session asks something,
- a session finished a turn you haven’t opened yet,
- CI on its branch fails,
- its pull request has changes requested or conflicts.
Act on several at once
Ctrl+click (Cmd+click on macOS) rows to pick them, and Shift+click to pick a run of them. A bar under them can:- settle their sessions,
- close them: their tabs close and idle agents stop, and the worktrees stay,
- delete the worktrees, after one question. Branches stay, and so does the main checkout.
Move between tabs
The window has one row of tabs for every environment. Going to a tab shows its environment, and going to an environment shows the tab it showed last.
A middle click closes a tab. Drag a tab left or right to move it; the order stays after a restart.