Basic Usage

Opening the Chat Panel

You can open the Agent Client chat panel in two ways:

• Ribbon Icon: Click the robot icon in the left ribbon

• Command Palette: Open the command palette (Cmd/Ctrl + P) and search for "Open chat view"

The chat panel opens in the right sidebar.

Sending Messages

1. Type your message in the input field at the bottom
2. Press Enter or click the send button
3. Wait for the agent's response

Sending Images and Files

You can attach images and files to your messages by pasting or dragging and dropping.

1. Paste: Copy a file or image and paste (Cmd/Ctrl + V) in the input field
2. Drag and Drop: Drag files directly onto the input area

Attached files appear as thumbnails or file icons below the text area. Click the × to remove.

TIP

Embedding images requires agent support. Non-image files are always sent as file path references.

See Sending Images and Files for more details.

Switching Agents

To switch agents for the current view:

1. Click the ⋮ (ellipsis) menu in the chat header
2. Under "Switch agent", select the agent you want to use

This is a one-time change for that view only.

TIP

To change the default agent for new chat views, go to Settings → Agent Client → Default agent.

Multiple Chat Views

You can open multiple chat views to run independent conversations simultaneously. Each view has its own agent process and session.

See Multi-Session Chat for details on:

• Opening multiple views
• Broadcast commands
• Focus navigation

Floating Chat

A draggable, resizable chat window that floats over your workspace. Enable it in Settings → Agent Client → Floating chat.

See Floating Chat for details.

Embedded Chat Blocks

Embed a live chat — or a quick-action button — directly inside a note using a fenced code block. The chat renders inline in Reading view, next to the content it is about.

```agent-client
type: chat
```

See Embeddable Agent Blocks for chat and button options, persistence, and examples.

Changing Models and Modes

Below the input field, you'll find dropdowns to:

• Change Model: Switch between different AI models (e.g., Sonnet, Haiku for Claude)
• Change Mode: Switch agent modes (e.g., Plan Mode)

TIP

Available models and modes depend on the active agent.

Starting a New Chat

Click the New Chat button in the header to start a fresh conversation. The previous chat can optionally be exported (see Settings).

Stopping Generation

If the agent is generating a response and you want to stop it, click the Stop button that appears during generation.