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

# Chat

> Conversations, bookmarks, pinned conversations, forking, keyboard shortcuts, and sharing chats in ClickHouse Agents

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Beta feature. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        Learn more.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

The chat surface in ClickHouse Agents handles conversations, branching, and sharing.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/chat.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=40b793ab5116b74db09a7e7d949c43ab" alt="ClickHouse Agent chat surface showing the left navigation, the agent identity header, and the message composer" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/chat/chat.webp" />

<h2 id="conversations">
  Conversations
</h2>

Start a new conversation by clicking the compose icon in the left navigation.
Select the agent you wish to use from the Agent selector dialogue at the top left of the conversation window - by default the **ClickHouse Agent** is selected.
You can now type your message in the composer, and press send. Each conversation is saved to your sidebar history and can be reopened, renamed, or deleted later.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/conversation.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=e2136c5ef501977addd78dc876ec4506" alt="Chat surface with the compose icon highlighted in the left navigation, the sidebar showing the Chats history with a saved Top 10 Tables Ranked conversation, and the composer with a sample question typed" size="lg" width="3838" height="1934" data-path="images/cloud/agent-builder/chat/conversation.webp" />

You can edit any of your messages in place, and the agent will regenerate its response from that point in the conversation history.
You can also regenerate the agent's last response only, without re-sending your message.

<h2 id="bookmarks">
  Bookmarks
</h2>

Bookmark a message or a whole conversation to flag it for quick retrieval. Bookmarks are private to you and survive conversation renames.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/bookmark.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=4dcc2c1f6ca113239ee66fd92d4249af" alt="Chat header with the bookmark icon highlighted and an Add Bookmarks tooltip visible" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/chat/bookmark.webp" />

<h2 id="pinned-conversations">
  Pinned conversations
</h2>

Pin a conversation to keep it at the top of the sidebar, separate from the date-grouped history below. Open the conversation's options menu (the three-dot icon) in the sidebar and select **Pin**. Pinned conversations collect in a **Pinned** section above the **Today**, **Yesterday**, and older groups.

To unpin, open the same menu and select **Unpin**.

<h2 id="forking">
  Forking
</h2>

Forking creates a new conversation branched from a specific message. You can use it to explore an alternative path without disrupting the original thread.
There are three fork modes available:

* **Visible messages only** - lets you copy the direct path to the forked message.
* **Include related branches** - lets you copy the main path plus any existing branches.
* **Include all to here** - lets you copy everything up to the forked message.

Forked conversations are independent, so changes don't sync back to the original.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/fork.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=625c66f6474f782c4f9c7bd7621501b3" alt="Select a fork option dialog showing three fork mode icons, Start fork here and Remember checkboxes, and the message action toolbar below" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/chat/fork.webp" />

<h2 id="sharing-chats">
  Sharing chats
</h2>

Generate a shareable link for any conversation to send it to a teammate or save it for reference. Recipients see a read-only view, including artifacts and visible branches. You can revoke a link from the sharing dashboard at any time.

Edits to existing messages appear in the shared view; messages added after the link was generated do not.

Anyone viewing a shared link can pick up the conversation in their own account by clicking **Continue this chat**. This copies the conversation — including the branch they're viewing — into their history as a new, private conversation, leaving your original untouched.

To share a conversation, open its menu in the sidebar and select **Share**:

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/share.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=b17141a695c412b3e6257f636fdc4ef3" alt="Conversation menu in the sidebar with Share, Rename, Duplicate, Archive, and Delete options visible" size="lg" width="3838" height="1934" data-path="images/cloud/agent-builder/chat/share.webp" />

Then click **Create link** in the share dialog:

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/share-modal.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=58d6f829ef37ec6b5f29788431b9b080" alt="Share link to chat dialog with the Create link button and a note that your name and any messages added after sharing stay private" size="md" width="1098" height="424" data-path="images/cloud/agent-builder/chat/share-modal.webp" />

<h2 id="keyboard-shortcuts">
  Keyboard shortcuts
</h2>

Open the keyboard shortcuts reference with `Cmd+Shift+/` (`Ctrl+Shift+/` on Windows and Linux), or from the account menu under **Help** → **Keyboard shortcuts**. Every shortcut is customizable: click a row in the dialog to record a new combination, and use **Reset all to defaults** to revert.

The default shortcuts are:

| Action                  | macOS                 | Windows and Linux      |
| ----------------------- | --------------------- | ---------------------- |
| Show keyboard shortcuts | `Cmd+Shift+/`         | `Ctrl+Shift+/`         |
| New chat                | `Cmd+Shift+O`         | `Ctrl+Shift+O`         |
| Focus chat input        | `Shift+Esc`           | `Shift+Esc`            |
| Upload file             | `Cmd+Shift+U`         | `Ctrl+Shift+U`         |
| Copy last response      | `Cmd+Shift+;`         | `Ctrl+Shift+;`         |
| Submit message          | `Cmd+Enter`           | `Ctrl+Enter`           |
| Toggle sidebar          | `Cmd+Shift+S`         | `Ctrl+Shift+S`         |
| Open model selector     | `Cmd+Shift+M`         | `Ctrl+Shift+M`         |
| Focus search            | `Cmd+/`               | `Ctrl+/`               |
| Open settings           | `Cmd+Shift+,`         | `Ctrl+Shift+,`         |
| Bookmark conversation   | `Cmd+Shift+B`         | `Ctrl+Shift+B`         |
| Stop generating         | `Cmd+Shift+X`         | `Ctrl+Shift+X`         |
| Regenerate response     | `Cmd+Shift+E`         | `Ctrl+Shift+E`         |
| Edit last message       | `Cmd+Shift+I`         | `Ctrl+Shift+I`         |
| Continue response       | `Cmd+Shift+C`         | `Ctrl+Shift+C`         |
| Copy last code block    | `Cmd+Shift+K`         | `Ctrl+Shift+K`         |
| Scroll to top           | `Cmd+Shift+Up`        | `Ctrl+Shift+Up`        |
| Scroll to bottom        | `Cmd+Shift+Down`      | `Ctrl+Shift+Down`      |
| Archive conversation    | `Cmd+Shift+L`         | `Ctrl+Shift+L`         |
| Delete conversation     | `Cmd+Shift+Backspace` | `Ctrl+Shift+Backspace` |

You can also assign your own shortcuts to open panels such as agents, prompts, files, and bookmarks — these have no default keys.