Open the attach menu
Click + in the message box, or type @. Under Attach to this message you’ll find:
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 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 ⌘ Z straight after pasting to put the text back in the message box.
- Press ⌘ ⇧ V 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 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 ⌘ L or right-click and choose Add selection to chat. The chip says Terminal selection.
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.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.- Attach the Wonder files and canvas layers to a message.
- Click +, choose Design references, then Save attached as a collection.
- Give it a name and, if you like, a note on what the agent should take from them, then save.
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.