Files & Attachments

Attach files to an orb thread when the task starts with more than text or source code. Amp can work with screenshots, videos, audio, PDFs, logs, spreadsheets, datasets, archives, and other files.

Attach a File

Use the attachment button in the message composer, drag files into the composer, or paste a file from the clipboard. Add instructions that explain what the file contains and what result you want.

Watch this screen recording, reproduce the problem in the app, and fix what causes the layout to jump when the menu opens.
Analyze these logs. Group related errors, identify the first failure in each group, and tell me which one is most likely to explain the outage.

The normal upload limit is 100 MB per file. Users with the higher upload limit can upload files up to 512 MB.

The Amp apps for macOS, iOS, and Windows add a few more ways to attach things:

  • iOS: the attachment button can take a photo or video with the camera.
  • macOS, iOS, and Windows: share an image from another app’s share sheet, or from Share in Windows. It opens in Puck.

To put a file directly into the orb’s file system instead of attaching it to the thread, drop it onto the Files pane or paste it into the terminal. See Upload Files to an Orb.

How Amp Uses Attachments

Attachments remain private to the thread and are not automatically copied into the repository. Amp can inspect images, PDFs, audio, and video directly. For other file types, Amp downloads the file into the orb when it needs local tools to read or transform it.

Tell Amp when the original file must remain unchanged or when generated output belongs in a particular directory.

See and Delete Attachments

Choose Attachments in the thread menu to see every file stored with the thread: files attached to messages, and files the agent uploads, such as screenshots and recordings. A Public badge marks a file Amp published, and a Temporary badge marks a file that expires a few hours after it was added. People who can delete the thread can delete attachments one at a time or all at once.

Attachments are copies stored with the thread. They are separate from the files in the orb’s Files pane, so deleting an attachment does not change the orb.

Useful Tasks

  • Record a problem in your app and ask Amp to reproduce and fix it.
  • Attach logs or a diagnostic archive for investigation.
  • Turn a presentation or spreadsheet into an interactive web page.
  • Analyze a CSV or other dataset and build a report.
  • Transcribe or summarize audio and video.
  • Generate a new image, video, document, or model from reference material.

Share Generated Files

Files created in the orb stay in its workspace unless Amp attaches or publishes them. Ask for the kind of result you need:

Create a CSV with the cleaned rows and attach it to your final reply.
Publish the finished demo video so I can share it outside this thread.

Only publish a file when it is safe for anyone with the URL to access it. Regular thread attachments remain protected by Amp’s access checks.