obsidian-plugin/rait-09_obsidian-agent-client
1
0
Fork 0
mirror of https://github.com/rait-09/obsidian-agent-client.git synced 2026-07-22 06:43:37 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
rait-09_obsidian-agent-client/docs/usage/floating-chat.md

2.9 KiB
Raw Blame History

Floating Chat

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

Floating chat window open over the editor

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

Floating button in the bottom-right corner

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 "Open new view" from the ⋮ (More) menu in the floating window header
  • Or use the command "Open new floating chat view" from the command palette

Switching Between Windows

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

Instance menu with multiple sessions listed

  • 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 view Open an existing floating window, or create one if none exist
Open new floating chat view Always create a new floating window
Minimize floating chat view Hide the focused floating window (session is preserved)
Close floating chat view 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