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

# Conversation Management

> Managing chat history — create, search, edit, organize into folders, export

Cloosphere automatically saves every conversation. From the sidebar you can search chat history, organize chats into folders, and export them in various formats.

## Starting a New Conversation

<Steps>
  <Step title="Click the New Chat button">
    Click the **New Chat** button at the top of the sidebar, or use the `Ctrl + Shift + O` shortcut.
  </Step>

  <Step title="Pick a model">
    Choose the AI model from the dropdown in the chat header. If you don't pick one, the default model is used.
  </Step>

  <Step title="Type and send">
    Type your question or request in the input box and press `Enter` to start. The chat title is auto-generated from the first message.
  </Step>
</Steps>

<Tip>
  Enable **Temporary Chat** mode to skip saving the conversation history. Useful for testing sensitive content or one-off questions.
</Tip>

## Searching Chat History

Use the search box at the top of the sidebar to find conversations.

* **Title search**: Search by auto-generated chat titles
* **Content search**: Full-text search of conversation content
* **Tag filter**: Use `tag:tagname` syntax to filter conversations with a specific tag

<Note>
  The chat list uses scroll-based pagination. Older conversations load automatically as you scroll down.
</Note>

## Chat Menu

Hover over a chat item to reveal the **More (...)** button — clicking it opens action options.

<Frame caption="Chat context menu">
  <img src="https://mintcdn.com/cloocus/jo_Hh1nBizxj0BOc/images/en/chat/conversations-context-menu.png?fit=max&auto=format&n=jo_Hh1nBizxj0BOc&q=85&s=29a8a904f35b6393fe3e452b98387d5e" alt="Chat context menu" width="1910" height="907" data-path="images/en/chat/conversations-context-menu.png" />
</Frame>

| Menu            | Description                                                       |
| --------------- | ----------------------------------------------------------------- |
| **Pin / Unpin** | Pin important conversations to the top of the sidebar             |
| **Rename**      | Manually change the auto-generated chat title                     |
| **Clone**       | Copy the current conversation into a new chat                     |
| **Archive**     | Hide a conversation from the list without deleting it             |
| **Share**       | Generate a share link ([Sharing details](/en/chat/sharing))       |
| **Download**    | Export the chat as JSON (.json), plain text (.txt), or PDF (.pdf) |
| **Delete**      | Permanently delete the conversation                               |
| **Tag**         | Add or remove category tags                                       |

## Editing and Deleting Messages

### Editing User Messages

When you edit a sent user message, the **original message is preserved** and the AI generates a new response based on the edit. This creates a conversation branch.

<Columns cols={2}>
  <Frame caption="Original question (1/2)">
    <img src="https://mintcdn.com/cloocus/jo_Hh1nBizxj0BOc/images/en/chat/conversations-branch.png?fit=max&auto=format&n=jo_Hh1nBizxj0BOc&q=85&s=59a4d169e595515caecc7b409505a7aa" alt="Original question branch" width="901" height="853" data-path="images/en/chat/conversations-branch.png" />
  </Frame>

  <Frame caption="New branch after editing (2/2)">
    <img src="https://mintcdn.com/cloocus/jo_Hh1nBizxj0BOc/images/en/chat/conversations-branch-edited.png?fit=max&auto=format&n=jo_Hh1nBizxj0BOc&q=85&s=7dbfe9fd9a0b3fe552b5160bc62fbf3e" alt="New branch after editing" width="893" height="859" data-path="images/en/chat/conversations-branch-edited.png" />
  </Frame>
</Columns>

<Steps>
  <Step title="Hover the message">
    Hover over the message you want to edit.
  </Step>

  <Step title="Click the edit button">
    Click the **Edit** icon that appears on the right side of the message.
  </Step>

  <Step title="Edit and send">
    Type your edits and click **Send** — the AI generates a new response.
    Click **Save** to update the content only without generating a new response.
  </Step>
</Steps>

### Editing AI Responses

You can directly edit AI responses too. Editing preserves the original so you can revert at any time.

### Deleting Messages

When you delete a message, its child responses are reattached to the parent so the conversation flow stays intact.

### Branch Navigation

When a message has multiple branches, an indicator like `1/3` appears below it. Use the left/right arrows to navigate between branch responses.

```mermaid theme={null}
graph TD
    U1[User question] --> A1[AI response 1/2]
    U1 --> A2[AI response 2/2 - regenerated]
    A1 --> U2[User follow-up]
    U2 --> A3[AI response]
```

## Project Management

Projects are independent workspaces isolated from personal chats. Instead of dragging chats in, you create and manage chats inside a project.

<Steps>
  <Step title="Create a project">
    Hover over the **Projects** header in the sidebar — a **+** button (**Create Project**) appears on the right. Clicking it opens the project creation page.
  </Step>

  <Step title="Enter project details">
    Select a project type, enter a name and description, then click **Create Project**.
  </Step>

  <Step title="New chat in the project">
    From the project page, start new chats and manage the project with the **Chat** and **Settings** tabs.
  </Step>
</Steps>

<Columns cols={2}>
  <Frame caption="Create Project (1/2)">
    <img src="https://mintcdn.com/cloocus/jo_Hh1nBizxj0BOc/images/en/chat/conversations-project-create.png?fit=max&auto=format&n=jo_Hh1nBizxj0BOc&q=85&s=a0758f5d3fc0e21ebe5bb8b5dea29b8e" alt="Create Project page" width="598" height="364" data-path="images/en/chat/conversations-project-create.png" />
  </Frame>

  <Frame caption="Inside a project — new chat (2/2)">
    <img src="https://mintcdn.com/cloocus/jo_Hh1nBizxj0BOc/images/en/chat/conversations-project-inside.png?fit=max&auto=format&n=jo_Hh1nBizxj0BOc&q=85&s=daccc823bf067ac3b6ad92b83af869c3" alt="Inside a project" width="776" height="375" data-path="images/en/chat/conversations-project-inside.png" />
  </Frame>
</Columns>

## Folder Management

Alongside projects, you can also organize conversations into plain **folders**.

<Steps>
  <Step title="Create a folder">
    Hover over the **My Chats** header in the sidebar — a **+** button (**New Folder**) appears on the right. Clicking it creates a folder named **Untitled**; rename it via the folder's **More (...)** > **Rename** menu.
  </Step>

  <Step title="Move a chat to a folder">
    Drag a chat item into the folder you want.
  </Step>

  <Step title="Manage folder structure">
    Drag one folder into another to nest it as a sub-folder for hierarchical management.
  </Step>
</Steps>

<Frame caption="Sidebar folder structure and folder menu">
  <img src="https://mintcdn.com/cloocus/jo_Hh1nBizxj0BOc/images/en/chat/conversations-folder-create.png?fit=max&auto=format&n=jo_Hh1nBizxj0BOc&q=85&s=f11d22e9c47278798833ca31fec4420f" alt="Sidebar folder structure and folder menu" width="385" height="185" data-path="images/en/chat/conversations-folder-create.png" />
</Frame>

The folder's **More (...)** menu provides **Rename**, **Export**, and **Delete**. Deleting a folder removes the folder **and all its contents** after confirmation.

<Tip>
  Collapse and expand folders to use sidebar space efficiently.
</Tip>

## Exporting Conversations

### Exporting Individual Chats

Choose the format from the **Download** sub-menu in the chat menu.

<Tabs>
  <Tab title="JSON (.json)">
    Complete format including message history, metadata, and branch structure.
    Can be **imported** into another Cloosphere instance.
  </Tab>

  <Tab title="Text (.txt)">
    Plain-text format with only roles (USER/ASSISTANT) and message content.
    Suitable for simple archival or external tools.
  </Tab>

  <Tab title="PDF (.pdf)">
    Exports as A4 PDF. The current theme (light/dark) is applied,
    and long conversations are auto-paginated.
  </Tab>
</Tabs>

### Bulk Export / Import

Settings > **Chats** tab lets you manage all conversations at once.

<Frame caption="Settings — Chats tab">
  <img src="https://mintcdn.com/cloocus/jo_Hh1nBizxj0BOc/images/en/chat/conversations-settings-chats.png?fit=max&auto=format&n=jo_Hh1nBizxj0BOc&q=85&s=0630889031ccb22cb009dd1d4f2254cd" alt="Settings — Chats tab" width="1913" height="906" data-path="images/en/chat/conversations-settings-chats.png" />
</Frame>

| Feature               | Description                                                                      |
| --------------------- | -------------------------------------------------------------------------------- |
| **Import Chats**      | Import conversations from a JSON file (OpenAI export format also auto-converted) |
| **Export Chats**      | Export all conversations as `chat-export-{timestamp}.json`                       |
| **Archived Chats**    | View and restore archived conversations                                          |
| **Archive All Chats** | Archive all conversations (with confirmation)                                    |
| **Delete All Chats**  | Permanently delete all conversations (with confirmation)                         |

<Warning>
  **Delete All Chats** is irreversible. Export important conversations first.
</Warning>

## Bulk Actions

Hold Shift while hovering over a chat item to instantly show archive/delete buttons for fast per-item actions.

## Archive Management

Archived conversations are hidden from the sidebar list but not deleted.

<Steps>
  <Step title="View archived conversations">
    Click Settings > Chats > **Archived Chats** to open the archive list.
  </Step>

  <Step title="Restore or delete">
    Restore an individual conversation from the list back to the sidebar, or delete it permanently.
    To bulk-restore all archived conversations, click the **Unarchive All Archived Chats** button and then select **Unarchive All** in the confirmation modal. You can also bulk-export them with the **Export All Archived Chats** button.
  </Step>
</Steps>