The window and the session list

The Buff Code window has two parts. On the left is the column: the app’s sections, open sessions and the list of all sessions. On the right is whatever is selected: Home, a session, automations or workflows.

The column

From top to bottom:

The column is visible with the vertical tab layout — it is on by default. Horizontal tabs at the top are chosen in “Settings → Appearance → Tabs”.

Session state

Under a row’s title there is the project directory and, if the session needs something from a person, its state in a word. What needs you comes first:

A permission request from a subagent counts towards its main session: the list shows which of your sessions is waiting.

Pinning, groups, archive

A row’s menu opens with the right mouse button:

• The group header’s menu — “Edit group” (name and colour) and “Delete group — sessions stay”: the sessions return to the by-day list.
• Archive instead of deletion. The session does not change: it goes to the collapsed “Archive · N” section at the bottom of the column and comes back from there with “Restore from archive”.
• Pinning, groups and the archive are the same for the window and the console: what is pinned in the window is pinned in buff too.

Home

• Projects — the folders you have worked with. The folder icon next to the heading opens a new one. On first launch the window creates a “Default Project” — you can start with it without choosing a folder.
• Sessions — by day, each with its project. A thin line to the left of a row means the session is open in a tab.
• Search sessions at the top searches by title. New session — in the selected project.

Searching the conversations

You can find a session not only by its title but also by the text of the conversation: what you asked and what the agent answered.

• Ctrl+Alt+F or the command palette → “Search the conversations” — from anywhere in the window. The results have one row per session: an excerpt with the match highlighted, who wrote it (“you” or “answer”) and how many more matches the session has. A click opens the session.
• In the column’s “Search by title” line the same matches come as an “In the conversation” section under the title matches.
• Letter case does not matter. The text of messages and answers is searched; tool output, the model’s thinking and subagents’ conversations are not included.

In the console

The console’s session list opens with the /sessions command. It has the same marks:

Search in the list covers the conversations too — an “In the conversation” section with an excerpt.