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
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
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.
Managing sessions via the API
All session endpoints are under /api/v1/session/. Chat history endpoints are under /api/v1/chat/.List sessions
Returns all sessions for the authenticated user.Create a session
A display name for the new session.
Returns the created session object with a 201 status.Rename a session
PATCH /api/v1/session/:sessionId
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.