> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mira-app.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Session Management

> Pin, rename, duplicate, and delete sessions. Understand how MIRA persists conversation history.

## The session sidebar

The left sidebar lists all your past sessions. You can switch between a **time-based** view (Today / Yesterday / This week / Older) and a **type-based** view (Chats / Skills / Workflows) using the toggle icon in the sidebar header.

Filter tabs let you narrow the list to **Chats**, **Skills**, or **Workflows** at a glance.

## Searching sessions

Use the search bar at the top of the sidebar to find sessions. It supports:

| Query           | Result                                                            |
| --------------- | ----------------------------------------------------------------- |
| Any text        | Matches session title, active skill name, or active workflow name |
| `type:chat`     | Shows only plain chat sessions                                    |
| `type:skill`    | Shows only skill sessions                                         |
| `type:workflow` | Shows only workflow sessions                                      |
| `@today`        | Shows sessions updated today                                      |

## Session actions

Right-click any session to open the context menu:

| Action        | Description                                                                                 |
| ------------- | ------------------------------------------------------------------------------------------- |
| **Rename**    | Enter a new title and press Enter to save.                                                  |
| **Pin**       | Pinned sessions stay at the top of the sidebar regardless of recency. Click again to unpin. |
| **Duplicate** | Creates a copy of the session with the same title and type.                                 |
| **Export**    | Saves basic session metadata as a JSON file.                                                |
| **Delete**    | Removes the session and all its messages from the database.                                 |

## Persistence

Every session and every message is stored locally in `mira.db` (SQLite). Sessions survive:

* App restarts
* Engine restarts
* System reboots

Nothing is ever synced to a cloud service.

## Resuming a session

Click any session in the sidebar to open it. The full message history loads instantly.

If a session had a Skill or Workflow active when it was created, those are shown in the session context bar. You can change or detach them from there.

## Deleting all history

To remove all sessions and messages at once, go to **Settings → Reset Data** and click **Clear All History**. A confirmation dialog is shown — this action is irreversible.

<Warning>
  Deleting history also removes all document associations. Uploaded document files on disk are not
  deleted — only the parsed chunks and session links stored in `mira.db` are removed.
</Warning>