Tab groups

A tab group puts a name and a color on a set of tabs. Its chip sits at the head of its tabs in the tile's bar, and each tab of the group carries the group's color along its bottom edge. Groups are kept: close all their tabs, or quit Termo, and the group stays, ready to open its tabs again.

Create a group

Right-click a tab → Add to new group. The group is created with the next free color, and its editor opens so you can name it and pick another color. A group without a name shows as a dot of its color.

You can also create an empty group from the Tab groups panel with + (New group).

Put tabs in a group, or take them out

  • Right-click a tab → Move to group and pick the group, or New group….
  • Right-click a tab of a group → Remove from group.
  • Drag a tab between two tabs of a group and it joins that group. Drag a grouped tab away from its group, along the same bar, and it leaves it.

A group's tabs always stay together in a tile's bar.

Collapse and expand

Click a group's chip to collapse it: its tabs are hidden and the chip shows how many there are. Click it again to expand it. If the tab you are on belongs to a collapsed group, it stays visible.

Alerts on the chip

With AI Mode on, the chip shows a dot when a tab of the group has something for you:

  • Needs your input (yellow): while an agent waits on your answer, whether you've seen it or not.
  • Finished with an error (red) or Finished (green): only until you look at that tab. Once it has been on screen, the alert goes away; one that finishes while you're looking at it doesn't alert at all.

If several tabs have news, the most urgent one wins: an error, then needs your input, then finished. The first two pulse. The same dot appears on the group in the Tab groups panel, so you notice it even with the group collapsed.

Save memory in collapsed groups

Every console takes memory, mostly its shell's process (a PowerShell takes around 90 MB), even when its tab is out of sight. With Preferences → Console → Save memory in collapsed groups (under Sessions), the tabs of a group that stays collapsed for a while stop taking it until you open them again. After (minutes collapsed) sets how long; 10 minutes by default.

  • Put tabs to sleep: the tab lets go of its console, which keeps running. When you open the tab, it shows the console again, as it was. It needs Keep consoles running when Termo closes, just above it, which is what keeps the console running meanwhile.
  • Discard idle consoles: a console sitting at its prompt, with nothing running, is closed with its shell. When you open the tab, a new console starts in the same folder. What the old one showed stays above, in the scrollback, and an agent conversation it had open is reopened. A console with something running is put to sleep instead, when it can be.

A tab at rest shows dimmed. The tab you're looking at is never touched, and neither is one whose agent is working or waiting on you. An expanded group isn't touched either.

Move a whole group

Drag the chip, the same way you drag a tab:

  • Along the bar, to put the group somewhere else among the tabs.
  • Onto another tile, to move all of the group's tabs there.
  • Onto a tile's edge, to split that tile and give the group the new half (New pane).

The consoles keep running while they move.

Edit a group

Right-click a group's chip (or use ⋯ in the panel) to open its editor:

  • Type its name and choose its Color.
  • New tab in group opens a console next to its tabs.
  • Close group closes its tabs and keeps the group, to open again later. Open group does that for a closed one.
  • Ungroup leaves its tabs open and removes the group.
  • Delete group removes the group; its open tabs stay, without a group.

The Tab groups panel

The Tab groups button on the activity bar, Ctrl+Shift+Q (⌘⇧Q on macOS) or the ≡ menu → Tab groups opens a panel with every group. Each one folds open to list its tabs:

  • In an open group, click a tab to go to it, or × to close it.
  • A group whose tabs are closed shows as closed, with the tabs it last had. Click one of them, or the arrow (Open group), to open the group again as it was: each console in its folder, and each agent conversation resumed.

Under each open console's title, a second line shows what's going on in it:

  • What it is: the agent running in it (Claude Code, Codex, Gemini CLI, Copilot CLI or Grok), or else its shell.
  • With an agent, its state, with the same colors as the tab's dot: Running, Waiting, Error or Done. Waiting and Error pulse.
  • The ports something in that console listens on, like :5173 for a dev server or :5432 for a database. A port that answers HTTP shows in blue with an arrow: click it to open http://localhost:<port> in your browser. The panel checks every few seconds while it's open.

The button beside + (Show tabs in no group) adds a No group section at the end, with every tab that isn't in a group, showing the same.

Split from the tab menu

Right-clicking a tab also offers Split right, Split left and Split down: the tab moves to a new tile on that side. If it is the only tab in its tile, the new tile opens a console like it instead, in the same folder and group.

Groups and layouts

Saving a layout records which group each tab is in. Restoring it puts the tabs back in their groups, and brings back any group deleted since, with its name and color.