> ## Documentation Index
> Fetch the complete documentation index at: https://wonder.design/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Give your agent context

> Attach images, files, long pastes, Figma designs, terminal output and saved design references to a chat message, so your agent starts from what you mean.

Show your agent what you mean instead of describing it: attach a screenshot, a file, a Figma design or the error your terminal printed to the message you're writing. Each one shows as a chip in the message box and goes with that message when you send it.

**Before you start** · Desktop app · Free plan

Press <kbd>⌘</kbd> <kbd>L</kbd> to go to the chat's message box from anywhere in the app. To attach layers from the canvas, see [Add to chat from the canvas](https://wonder.design/docs/add-to-chat-from-the-canvas.md). To let a chat work with Wonder files, folders, other chats or worktrees for its whole conversation, see [Choose what a chat works with](https://wonder.design/docs/choose-what-a-chat-works-with.md).

## Open the attach menu

Click **+** in the message box, or type **@**. Under **Attach to this message** you'll find:

| Entry | What it attaches |
| - | - |
| **Files and images** | Files you pick from your computer. |
| **Terminal output** | What the worktree's terminal printed most recently. It shows when the worktree has a terminal open. |
| **Figma design** | The Figma design on your clipboard. |
| **Canvas selection** | The layers you've selected on the canvas. It shows when the chat is next to the canvas and you have layers selected. |

The **@** menu also finds files in the worktree (**Worktree files**), layers on the canvas (**Canvas**), open Wonder files (**Design files**) and your saved **Design references**. Type after the **@** to narrow the list.

## Attach images and files

Drag files onto the chat, paste them, or click **+** and choose **Files and images**.

* Each file can be up to 100 MB, of any type. Choose up to 20 files at a time; attach more in another message.
* A message can carry up to 5 images, and 12 MB of images in all.
* PNG, JPEG, GIF and WebP images go to your agent as pictures it can see. Wonder converts HEIC, TIFF, BMP and AVIF images for you.
* Other files attach as they are. Wonder also gives your agent a readable copy of PDFs and Office documents.
* Folders don't attach. Attach the files inside, or [add the folder to the chat](https://wonder.design/docs/choose-what-a-chat-works-with.md#add-a-folder) instead.
* A file that looks like a credentials file, such as a private key, isn't attached.

## Paste long text

When you paste more than 2,500 characters or 40 lines, Wonder attaches it as a text file instead of filling the message box. It shows as a chip named **Pasted text 1.txt**, numbered within the message.

* Press <kbd>⌘</kbd> <kbd>Z</kbd> straight after pasting to put the text back in the message box.
* Press <kbd>⌘</kbd> <kbd>⇧</kbd> <kbd>V</kbd> to paste anything as plain text.

## Attach a Figma design

There are two ways:

* **Copy layers in Figma and paste them in the message**, or choose **Figma design** in the **+** menu. Your agent gets the design's layout and up to 3 previews. The chip is named after the layer. Images in the design come along when your [Figma account is connected](https://wonder.design/docs/connections.md) and a Wonder design file is open beside the chat; otherwise they're left out, and the message says so.
* **Paste a link to a Figma frame or layer** (in Figma, **Copy link to selection**). Your agent gets the design's outline, the link and a preview. Links need your Figma account connected in **Settings > Connections**. Wonder reads the first 3 frame or layer links of a paste; the rest stay as text.

## Attach terminal output

* To send what the worktree's terminal printed most recently, click **+** and choose **Terminal output**. The chip says **Terminal output**.
* To send only part of it, select the text in the terminal, then press <kbd>⌘</kbd> <kbd>L</kbd> or right-click and choose **Add selection to chat**. The chip says **Terminal selection**.

Wonder hides secrets, such as tokens and passwords, before your agent sees the output.

## Mention another chat or worktree

Click **+** or type **@**, then choose **Link a chat or worktree** and pick one. A linked chat lets your agent read that chat's conversation; a linked worktree lets it work with that worktree's files. Links stay on the chat until you remove them. See [Link another chat or worktree](https://wonder.design/docs/choose-what-a-chat-works-with.md#link-another-chat-or-worktree).

## Save design references to reuse

A design reference collection is a set of Wonder design files and canvas layers you want your agent to look at again and again, such as your brand's best screens.

1. Attach the Wonder files and canvas layers to a message.
2. Click **+**, choose **Design references**, then **Save attached as a collection**.
3. Give it a name and, if you like, a note on what the agent should take from them, then save.

To use it, click **+**, choose **Design references** and pick the collection, or find it with **@**. Your agent opens the references only for design work, and only while your account can open their files. You can keep up to 30 collections, with up to 24 references each.

## If something goes wrong

* **"Some files weren't attached".** You picked more than 20 files at once. Attach the rest in another message.
* **"… is over 100 MB, so it wasn't attached."** Attach a smaller file, or put it in the worktree and mention it with **@**.
* **"Up to 5 images per message".** Remove an image, or send the rest in another message.
* **"Images exceed this message's size limit".** Attach fewer or smaller images.
* **"The agent can't see some images".** Wonder couldn't convert those images, or they were too large to, so they attached as files your agent can't look at. Save them as smaller PNG or JPEG images and attach them again.
* **"Connect your Figma account to attach designs from Figma links."** Connect Figma in **Settings > Connections**, then paste the link again.
* **"Your connected Figma account can't open that file."** Ask the Figma file's owner to share it with that account.
* **"Nothing attached".** The terminal hasn't printed anything yet.
* **"Select a chat first".** No chat is open. Open or start one, then attach again.

## Related

* [Add to chat from the canvas](https://wonder.design/docs/add-to-chat-from-the-canvas.md)
* [Choose what a chat works with](https://wonder.design/docs/choose-what-a-chat-works-with.md)
* [Manage your chats](https://wonder.design/docs/manage-your-chats.md)
* [Connections](https://wonder.design/docs/connections.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.