Folder groups

Tabs that share a working folder sit together in a group in the sidebar, like browser tab groups. A group is a label with its tabs listed under it. A folder with a single tab still gets a label, so the sidebar always looks the same.

What a group shows

A label with the folder’s name and a color. A line in that color runs down beside the group’s tabs.
If two folders have the same name, the label adds the parent folder (work/api, personal/api).
Hover the label to see the folder’s path and how many tabs the group has.
At the label’s right, the project’s icon opens its menu of actions and links (Project tools), the Project files button its Files tab, and + a new tab in the same folder, without the picker.

Collapsing a group

Click a group’s label to collapse it to just the label, and click again to expand it. A collapsed group still shows the most urgent status of its tabs, such as ! for a tab that needs your input. Collapse group and Expand group in the group’s menu do the same.

Changing a group’s color

A new group takes the first of eight group colors that no open group has.

Right-click the group’s label, in the full sidebar or the rail, and choose Change color….
Pick one of the eight swatches, which closes the picker, or choose any other color with the saturation and brightness square, the hue slider or the hex field (#12AB34, or #1A3).
The group changes color as you drag or type. Press Enter to close the picker.

Claudette remembers the color for the folder on this machine, so the group has it again after a restart, or when you open the folder again after closing its group.

Renaming a group

Rename a group when two folders have the same name in different places.

Right-click the group’s label and choose Rename….
Type a name in the box that opens beside the label, which starts with the label selected and the folder’s path under it.
Choose Rename, or press Enter. Cancel, Esc, or a click outside leaves the label as it was.

The label shows your name in place of the folder’s. Saving the box empty, or with the folder’s own label, goes back to the folder’s name, as does Reset name in the menu while the group has a name. Claudette remembers the name for the folder on this machine.

Reordering

Drag a tab to move it within its group. Its row is marked as a selected one is, and the list rearranges as soon as the pointer passes the middle of a neighbor. Drag a group by its label to move the group. A tab can’t be dragged into another group, because its folder is fixed, and pinned tabs stay ahead of the others in their group.

Move up and Move down in a tab’s menu move it from the keyboard or with a click.

Dragging a tab out onto the conversation shows it beside the tab you’re in instead: see Split panes.

Pinning a group

With many projects, the ones you work in all the time can be hard to find. Right-click a group’s label and choose Pin to the top to put the group first in the sidebar, or Unpin from the top to let it go. Pinned groups sit in a shaded band of their own at the top, with a line between them and the rest. They keep the order they were in among themselves, and stay ahead of the others. It works on Claude Code’s projects too, so a project with nothing open in it can be at the top.

Dragging a group by its label moves it among the pinned groups, or among the others, not from one to the other. The pins are remembered for each folder, on this computer.

Right-click a group’s label, in the full sidebar or the rail. The menu’s items are in sections under small titles, as in the header’s ≡ menu, with an icon before each; Change color…’s is the group’s color. The rail’s menu has no Pin to the top.

Tabs

Item	What it does
New tab here	Opens a tab in the group’s folder.
New tab in a worktree	For a folder in a git repository: opens a tab that works in a worktree of its own. See Worktree tabs.

Folder

Item	What it does
Open project files	Opens the folder’s Files tab. See The Project files button.
History for this folder	Opens History listing only this folder’s sessions.

Group

Item	What it does
Collapse group or Expand group	Collapses the group to its label, or expands it.
Pin to the top or Unpin from the top	Pins the group to the top of the sidebar, or lets it go. See Pinning a group.
Rename…	Names the group. See above.
Reset name	Goes back to the folder’s name. Shown while the group has a name.
Change color…	Picks the group’s color. See above.
Account ▸	Picks the account the group’s new tabs use. Shown once there’s an account besides Default. See A folder’s account.

Then, under a line:

Item	What it does
Close group	Closes the group’s tabs, except pinned ones. Not shown while the group is one of Claude Code’s projects with nothing open in it.

Close group doesn’t touch pinned tabs. See Closing and restoring.

Claude Code’s projects

New in the next release

The sidebar can list every folder Claude Code has sessions in on this machine, so you work in your projects straight from the sidebar, as you would from their folders in a terminal, instead of through the new tab picker or History.

Open Settings → Tabs → Claude Code’s projects.
Turn on Show Claude Code’s projects in the sidebar.

The first time Claudette starts with sessions to show, a card at the top of the sidebar asks instead: Show them in the sidebar turns the setting on, and Not now leaves it off. Either way it asks only once; the switch is in Settings after that.

With it on:

Every folder with sessions is a group, whether or not a tab is open in it. The ones with nothing open come after the groups with tabs, the most recently used first, and each works like any group: its + opens a tab there, and its menu has New tab here, History for this folder and the rest. A group with nothing open has no Close group; it goes when you turn the setting off, or when its folder no longer exists.
Past sessions. A group with nothing open lists the folder’s latest sessions straight away. Once a tab is open in it, they fold away under its tabs into a row such as 12 past sessions: click it to unfold the latest five, newest first, each with its name and, under it, when it was last used and how many messages it has. Click a session to pick it up in a new tab in the group, as History does. Show all in History…, under the five, opens History on the folder when there are more. A session that’s open in a tab isn’t listed, since its tab is above. Claudette remembers which folders you unfolded.
The sessions are the ones History lists: Claude Code’s own on this machine, including sessions you started in a terminal, and the session library’s. Claudette reads them when it starts, when you turn the setting on, and when it comes to the front, so a session started in a terminal meanwhile shows up.

Settings

Settings → Tabs → Claude Code’s projects → Show Claude Code’s projects in the sidebar: off until you choose. It belongs to this machine, since the folders differ from one machine to the next.

The Project files button

A button before a group’s + (tip: Project files) opens that folder’s Files tab, an explorer and an editor for the project. It’s the same as Open project files in the group’s menu. See Opening project files.

The account new tabs use

Once you’ve added an API-key account in Settings → Accounts, the group’s menu has Account ▸, which lists Default and each account with its color, the group’s ticked. The choice is for the group’s new tabs and is remembered for the folder on this machine. Tabs already open keep their account. A group that uses an account other than Default shows a small tag with the account’s name beside its label. See A folder’s account.