Skip to main content

Sessions

A session is a conversation with a single agent (or team). Sessions are stateful — the agent's STM accumulates throughout, and LTM is loaded at session start. You can have multiple sessions open simultaneously.

Starting a Session​

  1. Open the Console at ``
  2. In the Sessions view, click an agent in the left sidebar
  3. A new session opens in the main panel
  4. Type your first message and press Enter

DAEMI will:

  • Load the agent's profile (personality, memory policy, LLM config)
  • Query LTM for relevant context based on your first message
  • Prime the session with any relevant memories
  • Begin the conversation

The session ID is visible in the URL: /sessions/{session_id}.

Multiple Sessions​

You can have multiple sessions open at once — different tabs in the main panel, each with a different agent.

To open a second session: click any agent in the sidebar while a session is active. The new session opens in a new tab.

Sessions run independently — parallel conversations with different agents, no cross-contamination.

Session History​

Past sessions are listed in the agent's session history panel (click the clock icon in the sidebar, below the agent's name). Each session shows:

  • Start and end time
  • Message count
  • Whether LTM was written (indicated by a memory icon)
  • A preview of the first message

Click any past session to open it in read-only mode.

Switching Agents Mid-Session​

You can't switch agents within an existing session — the session is bound to one agent. To talk to a different agent:

  1. Open a new session with that agent
  2. Or close the current session and start fresh

If you want to pass context from one agent to another, use the Export context option (three-dot menu in session header) and paste it into a new session.

Session Persistence​

Sessions are stored in the DAEMI database at ~/.daemi/sessions/. They're not deleted automatically. To clean up old sessions:

# Via CLI
daemi sessions prune --older-than 30d

# Via API
DELETE /api/sessions?before=2026-02-01

Or use Settings → Storage → Prune old sessions in the Console.

Ending a Session​

Sessions don't need to be explicitly ended — closing the tab or navigating away ends the active context. DAEMI runs the STM → LTM distillation process in the background after the last message.

To explicitly close a session:

  • Click the ✕ on the session tab
  • Or press Ctrl+W

Go Deeper​

→ Memory

How STM and LTM work across sessions.

→ Console Overview

Tour of the full Console UI.