# Managing sessions

Create, switch, rename, archive, search, and group your sessions — all from the Sessions sidebar. The list organizes itself by attention and recency so the thread that needs you is always on top.

## Create and switch

- 01Start a sessionClick New session at the top of the sidebar (or press the new session command from the Command Center). You land in an empty conversation, ready for your first prompt.New sessionSessions sidebar → New session.
- 02Switch between sessionsClick any row to bring that conversation forward. Switching is instant — the engine replays the session’s history, and the editor follows it to the session’s active project. Foxora remembers your last-open session and returns you to it on the next launch.

## Name a session

New sessions get a title derived from your first prompt — the first line, trimmed and sentence-cased. To set your own:

- Rename — right-click a row (or open its ⋮ menu) and choose Rename, or press R. The title becomes an inline field. A name you set sticks; it won’t revert when the next prompt arrives.
- Regenerate name — let Foxora propose a fresh title from the conversation so far.

## Session status

Each row shows a small indicator that means “needs my attention.” The states map to the live run:

- Working — the agent is actively running.
- Waiting — it’s paused on a question or an approval from you.
- Done / Error — shown only while unseen — the run finished or failed while you were elsewhere. Open the session and the marker clears.
- Idle — a settled session; the row stays clean.

> Ongoing floats to the topAny session that’s working or waiting on you floats to the top of every group, so the thread you’re in the middle of is always the first thing you see.

## Search

Once you have enough sessions, a search field appears above the list (focus it with ⌘F / Ctrl+F). It matches case-insensitively across each session’s title and its attached project names and paths — so typing a project name finds every session that touches it, no extra filter needed.

## Group and sort

The view options menu (the sliders icon) controls how the list is laid out. Group by:

- Recency — automatic Needs attention, Today, Yesterday, This week, and Older buckets.
- Custom groups — your own named buckets. Drag a session onto a group to file it; create one from New group…. Everything ungrouped falls back to the recency buckets.
- Project — grouped by each session’s active project.
- Flat list — no headers, just rows.

Within a group, sort by Recently updated or Name, and use Show → Needs attention to hide everything that isn’t waiting on you.

> Grouping is localYour custom groups and view preferences are saved on this device. The sessions themselves live on the engine and follow you everywhere; the way you choose to arrange them is yours alone.

## Archive and delete

Done with a session but want to keep it? Archive it from the row menu. Archived sessions drop into a collapsed section at the bottom of the list — out of your inbox, still searchable, and unarchivable any time. To remove one for good, choose Delete (D); a confirmation reminds you it permanently removes the session and its history.