1# Session navigation
2
3## Session picker
4
5Open it with `SSP` in the palette. It lists local sessions and, if you added hosts, remote sessions as `session@host`.
6
7| Key | Action |
8|---|---|
9| ↑/↓ or `j`/`k` | move |
10| Enter | open the session or tab |
11| `/` | search (Escape leaves search) |
12| `s` | switch sort: recent first, or named before numbered |
13| `x` | kill the selected session |
14| Escape or `q` | close and go back |
15
16- Each row can expand to show its tabs, with a live preview of the selected one.
17- Remote sessions that cannot be opened show a tag such as `down` or `broken`.
18- While the picker is open, your keys never reach the shell underneath.
19
20## Jumping between sessions
21
22| Code / key | Action |
23|---|---|
24| `BCK` | back to the previous session |
25| `JRS <rank>` | jump to a recent session by rank |
26| Alt+a | jump to a session that needs attention (bell) |
27| `CNS` | create a named session; asks where when several daemons are available |
28| `CES` | create a numbered session |
29
30Recent-session history belongs to one client and is not saved. A new client starts with an empty history. A session that rings a bell also shows in the history with its bell, after the sessions this client visited, until any client sees it.
31
32A vev window only counts as seeing a bell while it has focus. With several vev windows open, a window on another workspace or behind another app never clears a bell, so the window you are using still shows it. This needs a terminal with focus reporting, such as kitty, foot, WezTerm, or Ghostty; other terminals keep treating every open window as seen. Focusing a vev window also resizes the session content to that window.
33
34## Move panes and tabs
35
36- `MFP` moves the focused pane to another tab.
37- `MAT` moves the current tab to another session.
38
39Both open a small picker to choose the destination.