Sessions
Every conversation in Codistry is a session: an independent chat with its own history and its own running task. The Sessions panel lists them all alongside your chat so you can jump between several pieces of work at once, keep an eye on what each one is doing, and keep the ones that matter close at hand.
Switching sessions never cancels a run. If one session is mid-task, it keeps streaming in the background while you read, reply in, or start another session, and you'll see its status update in the list when it needs you or finishes.
The Sessions panel
The panel sits beside the chat (it never overlaps the message text) and is open by default. Toggle it from the Sessions button in the chat title bar (the collection icon); its open/closed state is remembered across reloads, so it stays put while you work.
Collapses to a rail
When the sidebar is narrow, the panel collapses to a slim rail that shows a single letter avatar per session. Hover a row and the panel expands so you can read full titles.
Resizable & remembered
Drag the handle on the panel's left edge to widen it (up to a limit that keeps the chat usable); double-click the handle to reset to the default width. The width persists across reloads.
Start a new session
Use the + button in the panel header (or the title bar) to open a fresh session. Any in-progress session keeps running.
Status indicators
Each session row shows a colored dot when it needs your attention. Indicators mean “something changed while you were elsewhere”, and viewing a finished session clears its dot.
- Blue: the session is working on something (a query is running).
- Orange: the session needs your input (e.g. a tool is waiting for approval).
- Green: it finished while you were elsewhere and has results to review.
Naming a session
Give a session a meaningful name so you can find it later. There are two ways to rename, both edit the title inline:
- Double-click a session row, or
- open the row's ⋮ menu and choose Name Session.
Inline editing
The title becomes a text field with the current name selected. Press Enter to save, Esc to cancel (clicking away also saves). Names are capped at 100 characters; an empty name is ignored.
Pinning a session
Pin the sessions you keep coming back to. Open a row's ⋮ menu and choose Pin Session (choose Unpin Session to reverse it). Pinned sessions are grouped together and marked with a pin glyph.
A session stays within its group: reordering can't move a pinned session in among the unpinned ones (or vice versa). Membership only changes when you pin or unpin from the menu.
Reordering sessions
Arrange sessions by dragging. Press and hold a row briefly to “pick it up”, then drag it to a new position; the other rows make room as you move, and the new order is saved when you drop.
Press, then drag
A brief hold starts the drag, so a quick tap still just switches sessions.
Clamped to its group
Dragging reorders within the pinned or unpinned group only. To move a session between groups, pin or unpin it.
Deleting a session
Open a row's ⋮ menu and choose Delete Session. Because deletion is destructive, and stops the session's run if it has one, you'll be asked to confirm first.
Removing a session discards its conversation history. If you might want it later, consider renaming and keeping it instead.
- Quick Start, start your first session
- Personalization, what Codistry remembers across sessions