Guides

Attach screenshots and files to a Muse Code prompt

In Helicon, paste a screenshot into the composer, drag files onto it, or click the paperclip. You can send up to 10 files with one message, each up to 12 MB. Muse sees images directly. Any other file is written into .helicon/attachments in your project and mentioned in the prompt, so the agent reads it from there.

Last updated 29 October 2026 · Markdown version

Three ways to attach

Paste: copy a screenshot and press Cmd+V or Ctrl+V in the composer. Pasted text stays text; only files on the clipboard become attachments.
Drop: drag one or more files from Finder, Explorer or your file manager onto the composer.
Pick: click the paperclip and choose files.

Each attachment shows as a thumbnail or file chip above the text box. Remove any of them before you send, and click an image thumbnail to see it full size.

What happens to each file

File	Where it goes
Images (PNG, JPEG and other image types)	Sent to Muse with your message, so the model looks at the picture itself
Anything else (logs, PDFs, CSVs, code)	Written to .helicon/attachments/ in the project, and @-mentioned in the prompt so the agent opens it

If a file with the same name is already in that folder, Helicon adds -2, -3 and so on rather than overwriting it.

Limits

Up to 10 files per message.
Up to 12 MB per file. A larger file is refused with a message naming it.
Empty files are refused.
SSH projects take images only. Other files can't be written to the server from Helicon yet.

Keep attachments out of git

Non-image attachments are real files inside your project, so git will see them. If you don't want to commit them, ignore the folder:

echo '.helicon/' >> .gitignore

In the VS Code extension

Paste, drop and the paperclip all work in the VS Code panel from Helicon 0.23.1. Before 0.23.1, pasting an image did nothing there, because VS Code only hands text from the clipboard to extensions (issue #249). If paste still does nothing, update the extension, or use the paperclip.

Attach a screenshot to a Muse Code prompt in Helicon

Take or copy a screenshot. Any image on the clipboard works, or save it as a file.
Paste it into the composer. Press Cmd+V or Ctrl+V with the cursor in the message box. You can also drag the file in or use the paperclip.
Check the thumbnail. It appears above the text box. Click it to see it full size, or remove it.
Write the prompt and send. Say what you want done with the image, for example "match this layout" or "what is wrong in this error dialog".

Frequently asked questions

Can Muse Code read PDFs or log files I attach?

Yes, through the workspace. Helicon writes them to .helicon/attachments/ in your project and mentions the path in the prompt, so the agent opens them with its normal file tools.

Can I paste a screenshot in the VS Code extension?

Yes, from Helicon 0.23.1. Press Cmd+V or Ctrl+V in the panel's composer. Older versions could not, because VS Code's clipboard API only returns text to extensions. Update the extension if paste does nothing.

How big can an attachment be?

12 MB per file, and up to 10 files in one message.