Session management

Sessions are named conversation threads with isolated chat history. Create, switch, rename, and delete sessions from the CLI or the API.

A session is a named conversation thread. Each session has its own isolated chat history and short-term memory context. You can have as many sessions as you need — for example, one per course, one per project, or one per document set.

CLI

Managing sessions from the CLI

Command	Description
:sessions	List all sessions with labels, IDs, and message counts.
:new [label]	Create a new session. Switches to it immediately.
:switch <n>	Switch to session number n (1-indexed, as shown by :sessions).

Listing sessions

:sessions

Each row shows the 1-based index, the session label, a truncated session ID, and the last-active timestamp. The active session is highlighted.

Creating a session

# Auto-named session-N
:new

# Named session
:new biology-revision

The new session is immediately active. Its label appears in the prompt box.

Switching sessions

:switch 2

Quark confirms the switch and shows the message count for that session. Use :sessions first if you are unsure of the index.

Each session has its own chat history. Switching sessions does not carry over the conversation context from the previous session.

API

Managing sessions via the API

All session endpoints are under /api/v1/session/. Chat history endpoints are under /api/v1/chat/.

List sessions

GET /api/v1/session/

Returns all sessions for the authenticated user.

Create a session

POST /api/v1/session/

label · string · required

A display name for the new session.

Returns the created session object with a 201 status.

Rename a session

PATCH /api/v1/session/:sessionId

label · string · required

The new display name for the session.

Delete a session

DELETE /api/v1/session/:sessionId

Returns 204 No Content on success.

View chat history

GET /api/v1/chat/history/:sessionId?page=0

Returns paginated chat messages for the session. Each page contains up to 20 messages. The page query parameter is 0-indexed and defaults to 0.

Delete chat history

DELETE /api/v1/chat/:sessionId

Permanently deletes all chat messages for the session. The session itself is preserved.