# Floating Chat

A persistent, draggable chat window that floats over your workspace. Perfect for quick conversations without leaving your current view.

<p align="center">
  <img src="/images/floating-chat-view.webp" alt="Floating chat window open over the editor" />
</p>

## Overview

The Floating Chat provides a lightweight alternative to the sidebar chat view:

- **Draggable window** — move it anywhere on screen
- **Resizable** — drag the edges to adjust size
- **Collapsible** — hide the window without losing your session
- **Multi-window** — open multiple floating windows simultaneously
- **Independent sessions** — each window runs its own agent session

::: tip
Enable the floating chat in **Settings → Agent Client → Floating chat → Enable floating chat**.
:::

## Getting Started

1. Enable **Enable floating chat** in settings
2. A floating button appears in the bottom-right corner
3. Click the button to open a chat window
4. Start chatting — the window works just like the sidebar chat

<p align="center">
  <img src="/images/floating-chat-button.webp" alt="Floating button in the bottom-right corner" width="200" />
</p>

## Moving and Resizing

- **Drag** the header bar to move the window
- **Resize** by dragging the bottom-right corner of the window
- Position and size are saved automatically

## Multiple Windows

Open more than one floating chat window to run parallel conversations.

### Opening Additional Windows

- Click the **copy-plus** icon in the floating window header
- Or use the command **"Open new floating chat window"** from the command palette

### Switching Between Windows

When multiple windows exist, clicking the floating button shows an instance menu:

<p align="center">
  <img src="/images/floating-chat-instance-menu.webp" alt="Instance menu with multiple sessions listed" width="300" />
</p>

- Click a session name to expand that window
- Click **×** to close a session

::: tip
The focused floating window is always displayed in front of other floating windows.
:::

## Commands

| Command | Description |
|---------|-------------|
| **Open floating chat window** | Open an existing floating window, or create one if none exist |
| **Open new floating chat window** | Always create a new floating window |
| **Minimize floating chat window** | Hide the focused floating window (session is preserved) |
| **Close floating chat window** | Close the focused floating window and end the session |

::: tip
Assign keyboard shortcuts to these commands in **Settings → Hotkeys** for quick access.
:::

## Configuration

Customize the floating chat in **Settings → Agent Client → Floating chat**:

| Setting | Default | Description |
|---------|---------|-------------|
| **Enable floating chat** | Off | Enable the floating chat button and draggable chat windows |
| **Floating button image** | Default icon | URL or vault path to a custom button image |
