sessions & groups

Every session is a row in the sidebar and a shell of its own. Fleet spawns it through your login shell, so your PATH, prompt, aliases and dotfiles are exactly what you get in Terminal.

Starting one

⌘T for a shell, ⌘⇧T for an agent session. The sidebar’s ＋ button does the same, and its ▾ menu adds the rest: a session in a folder you pick, an agent session in a folder you pick, a saved launch profile, or a new group.

Right-click any row for New Session Here, which starts one in that session’s directory — the fastest way to open a second shell on the repo you are already in.

Right-clicking empty sidebar space offers everything that starts a session — a shell or an agent session, either in a chosen folder, or a saved profile — alongside New Group, collapse and expand all groups, Clear All Scrollback and Close All Sessions…. Right-clicking a group header starts a shell, an agent session, a shell in a chosen folder or a saved profile directly into that group.

New sessions, shell and agent alike, start in the directory set under Settings → Terminal, unless they were told otherwise.

Naming

Double-click a title to rename it. Claude’s own /rename sets a name too, and when both exist the most recent one wins — so if Claude renames a session after you did, rename it again. Reset Name on the right-click menu drops yours and goes back to whatever the session calls itself.

Colour and grouping

Right-click a row to colour it. Colour is yours to assign meaning to; the status icon is separate and always means status.

A group is a labelled band of rows. Create one from the ▾ menu or by right-clicking empty sidebar space, then drag rows in and out, or use Move to Group on a row’s right-click menu. Groups can be renamed, coloured — the colour shows on the rows inside — collapsed, and deleted without touching the sessions in them.

Rows cannot be dragged while Float sessions needing you to the top is on, because the sidebar is sorting them for you; Move to Group still works.

Collapsed groups are stepped over by the walk shortcuts, so folding a project away really does take it out of your way. ⌘K, the command palette and ⌘⇧J still reach the sessions inside.

Reading a row without leaving

Hover a row for about half a second and a preview opens: the recent conversation for a Claude session, the last lines of output for a shell. It does not appear for the session you are already in, or while a row is being dragged.

Hovering also puts a close button on the row.

Closing

⌘W closes the focused session; the last one closes the window. If something is still running there — an agent session, a npm install, an agent in that session’s Quick Terminal — Fleet asks first and names what it found. An idle shell closes straight away. The check is a setting.

Closing a session ends what was running in it. Fleet hangs up on the shell and everything it started, the way a terminal emulator does, and kills whatever is still there a moment later. Quitting Fleet does the same to every session.

Close the session when Claude exits under Settings → Terminal makes /exit end the pane too, rather than dropping you back to an empty shell. It is off by default, and offered once — the first time you close a pane by hand after Claude has already left it. Only a deliberate quit counts: /exit, Ctrl-D, or Ctrl-C twice. /clear, /resume and a crash leave the session where it is, because a crash’s error text is worth more than a tidy sidebar.

Coming back

Restore sessions on launch reopens what you had, each in its own directory, with its name, colour, group and position. Resume conversations on launch goes further and reopens the conversation each Claude Code, Codex or Antigravity session was last on. After a /clear that is the new conversation, not the one it replaced; a pane you quit Claude Code or Codex in comes back as a plain shell. Both are under Settings → Terminal, and resuming only applies while restoring is on.