AI Chat

The assistant panel opens beside the editor — at ⅓ Split View or in Slide Over it opens as a sheet instead. Open it with the AI button on the editor's navigation bar, or by picking anything from its menu.

You can drag the panel's edge narrower or wider, within limits.

How a conversation works

The first message carries the article — its title and its HTML — as context, so the model knows what you are talking about. You do not have to paste anything or explain what the article is.

• Picking a tool sends that tool's instruction as the first message.
• Picking Custom…, or opening the panel with the AI button directly, leaves the chat empty for you to type your own. A tool tells the model to rewrite something; Custom… does not, so a question like "how is the pacing of this article?" gets an answer rather than a rewritten article.

Type in the box at the bottom and press Send, or ⌘Return. Stop appears while a reply is arriving and abandons it.

Replies stream in word by word where the provider supports it. A tool's instruction is shown in a muted Instructions block rather than as something you said, so a long prompt does not dominate the conversation.

If you are using a model that reasons before answering, its scratchpad appears above the reply as a collapsible Thinking block — tap to unfold it. It is shown so you can see something is happening; it is never inserted into the article, sent back to the provider, or saved with the chat.

Doing something with a reply

Each reply carries three buttons.

Insert into editor puts the reply into the article at the cursor. The reply is converted from Markdown if necessary, and sanitised, so what lands in your article is clean HTML — no stray **bold** markers, no scripts. It lands as a single edit: one ⌘Z undoes the whole insert.

Copy copies the reply as you see it. Pasted somewhere that understands formatting — Mail, Pages, Notes — it keeps its headings, lists and emphasis; pasted into a plain text field it arrives as readable text.

Copy raw copies what the model actually wrote, Markdown markers, HTML tags and all, for when you want to work on the source rather than read it.

The panel header

New Chat starts a fresh conversation. If the current one is worth keeping, you are offered the chance to remember it first.

Close hides the panel, with the same offer.

Remembering a chat

When you close a non-empty conversation, Grafida asks whether to remember it. If you say yes:

• the local article is saved first, if it was not already;
• a title is generated for the chat if you have not given one;
• the whole conversation is stored alongside the article, with the article context stripped back out of the first message before it is saved.

Remembered chats appear in the AI Chats list at the top of the panel, where you can open one to continue it, rename it, or delete it.

Saved chats travel with the article: they are included in a .grafida export, and they are deleted when the local article is deleted.

When something goes wrong

The button is not there. No AI service is configured, or you configured one while the editor was already open. Add a service in the sidebar's AI destination, then go back to the article list and open the article again.

The provider rejects the request as soon as it is sent. If you switched on The model can see images for a text-only model, switch it back off — such a model rejects the whole request rather than ignoring the pictures. See AI Services.

The reply is about the wrong article. Press New Chat. The article is attached to the first message of a conversation, so a chat you carried over from another article — or reopened later — still has that one's text in it, or none at all.