Skip to main content

oblix sessions

The oblix sessions command provides tools for viewing and managing your chat history in Oblix.

Usage​

oblix sessions <subcommand> [options]

Description​

This command group allows you to work with your saved chat sessions from previous interactions with Oblix. It provides functionality for listing, viewing, creating, and deleting chat sessions.

Oblix automatically saves your conversation history from chat sessions, and this command helps you manage and access that history.

Subcommands​

SubcommandDescription
listList recent chat sessions
viewView details of a specific session
deleteDelete a specific chat session
createCreate a new chat session

List Sessions​

Lists recent chat sessions with their IDs, titles, creation timestamps, and message counts.

oblix sessions list \
[--limit NUMBER]

Options​

OptionDescription
--limitMaximum number of sessions to display (default: 50)

Example Output​

Recent Chat Sessions
Session ID | Title | Created | Messages
8c7f1e9a-8b4d-4f56-9a9d-6b5c9d8e7f6a | Quantum Computing Explained | 2023-05-10 14:30 | 12
7d9e8c6b-7a3e-5d45-8b8c-7a9b8c7d6e5d | Poetry Writing | 2023-05-09 10:15 | 8

View Session​

Displays the full conversation history for a specific session.

oblix sessions view <session_id>

Arguments​

ArgumentDescription
session_idUnique identifier of the session to view

Example Output​

┌─Session Overview──────────────────────────┐
│ Session ID: 8c7f1e9a-8b4d-4f56-9a9d-6b5c9d8e7f6a │
│ Title: Quantum Computing Explained │
│ Created: 2023-05-10T14:30:45.123456 │
│ Last Updated: 2023-05-10T15:10:22.654321 │
└────────────────────────────────────────────┘

Conversation:
User (2023-05-10 14:30:45): Can you explain quantum computing in simple terms?
Assistant (2023-05-10 14:30:52): Quantum computing is a type of computing that uses quantum phenomena...

Delete Session​

Deletes a specific chat session permanently.

oblix sessions delete <session_id>

Arguments​

ArgumentDescription
session_idUnique identifier of the session to delete

Safety Confirmation​

The command prompts for confirmation before permanently deleting a session:

Are you sure you want to delete this session? [y/N]:

Create Session​

Creates a new empty chat session with an optional title.

oblix sessions create \
[--title "Session Title"]

Options​

OptionDescription
--titleOptional title for the new session

Example Output​

New session created: 9d8c7b6a-5e4d-3f2c-1a9b-8c7d6e5f4g3h
Title: My Custom Session

Sessions Storage​

Chat sessions are stored locally on your machine in a JSON format. The storage location is:

~/.oblix/sessions/

Each session is saved as a separate JSON file with the session ID as the filename.

  • oblix chat - Start an interactive chat session that creates new session history