Skip to content

AI chat panel

The AI chat panel is a conversational writing assistant that lives in the right sidebar. Ask questions about your content, get suggestions, and insert AI-generated text directly into the editor. It is free on every plan.

Open the panel

Click the AI Assistant icon in the right icon rail, or press Cmd+Shift+/ (Mac) or Ctrl+Shift+/ (Windows/Linux) to toggle the panel from anywhere in the editor. You can also open it with the AI Chat slash command.

When a topic has no conversation yet, the panel shows an empty state with a few example questions above the input.

Quick actions

Quick-action chips at the top of the panel send a ready-made prompt in one click:

  • Writing chips: Draft outline, Draft a section, What's missing?, Improve writing, Simplify.

  • Project chips: Find reuse, Check style.

The prompt area also shows contextual chips based on active findings. For example, if a readability finding detects duplicate content, a "Check duplicates" chip appears. These chips change as you edit.

Click a chip to send it as a prompt. The AI responds with an answer, or with a suggested-content card you can insert.

Freeform conversation

Type any question or instruction in the text input. The AI can:

  • Answer questions about your content: "What topics reference this component?"

  • Generate content: "Write an introduction for this API reference."

  • Suggest improvements: "How can I make this procedure clearer?"

  • Explain concepts: "What is the difference between conditions and variables?"

The conversation is multi-turn. The AI remembers context from earlier messages, even across sessions. Conversations persist and auto-resume when you reopen a topic, so you can pick up exactly where you left off.

The panel header shows the active conversation's title with a chevron. Click it to open the conversation switcher: start a New chat, or pick from the Recent chats list, ordered by most recent.

Intent classification

The AI classifies your message to determine the best response:

  • Writing requests: handled by the writing assistant (draft, rewrite, expand, improve).

  • Management queries: routed to project data (find similar topics, list components, check content health).

Management queries use tool calls to fetch live data from your project, with results displayed as cards showing what was found and the action taken.

Review and insert suggestions

When a reply contains content meant for your document, it appears as a Suggested content card, not as raw text you copy. The card shows a preview and a location hint ("will replace your selection" or "at cursor"), with a single Insert suggestion action.

Insert suggestion opens an in-editor diff preview rather than pasting directly. Review the change there and Accept or Dismiss it, exactly like Inline AI editing. For a rewrite that overlaps existing content, the preview is color-coded block by block (added, removed, modified) with per-block accept and reject, so you can keep some changes and discard others.

Inserting AI content is disabled while Track changes and suggestions (track changes) is on. Turn Suggest mode off to apply a suggestion.

Reference other content with @/# mentions

Use mentions to bring additional context into the conversation:

  • Type @ to reference a topic by name. The AI sees its full content.

  • Type # to reference a component by name. The AI sees its content and where it is used.

A picker appears as you type, showing matching items from your project. Select one to include it in your message. This gives the AI additional context about the content you are discussing, which leads to more accurate and relevant responses.

Context visibility

A collapsible section at the top of the panel shows what the AI can see: the current topic name, the number of components, references, and variables in the topic, and which maps it appears in. Expand it to verify the AI has the context you expect.

Use the chat panel for exploratory writing. Ask "What should this section cover?" or "How do competitors document this feature?" before generating a draft. The multi-turn conversation lets you refine the direction before committing to content.

See also

Was this page helpful?