Skip to main content
Attach files to your tasks so AI agents can reference screenshots, code snippets, data files, and documents while working.

​
How to upload

​
Drag and drop

Drag files directly onto the task composer or an active task to upload them. Multiple files can be dropped at once.

​
File picker

Click the attachment button in the task composer to open your system file picker and select files.

​
Paste images

Paste images directly from your clipboard into the task composer. This is useful for quickly sharing screenshots — only image files are supported via paste.

​
Limits

ConstraintLimit
Max file size25 MB per file
Max attachments10 files per task
Max file name length255 characters

​
Supported file types

.png, .jpg, .jpeg, .gif, .webp, .svg, .bmp, .tiff
.pdf, .txt, .md, .rst, .log
.ts, .tsx, .js, .jsx, .py, .go, .rs, .java, .c, .cpp, .h, .rb, .swift, .kt, .sh, .bash
.json, .yaml, .yml, .toml, .xml, .ini, .env, .cfg, .conf
.csv, .tsv
.html, .css

​
Blocked file types

Executable and binary files are blocked for security: .exe, .dmg, .app, .bat, .cmd, .com, .scr, .pif, .msi, .dll, .so, .dylib, .jar, .war, .ps1, .vbs, .wsf
If you try to upload a blocked file type, the upload will be rejected with an error message.

​
How files reach AI agents

When a task starts, Whim makes your attached files available to the AI agent automatically:
  1. File metadata is injected into the task container via the WHIM_ATTACHMENTS environment variable
  2. Each attachment is represented with a sanitized file name and a signed download URL (valid for 1 hour)
  3. The AI runtime (Claude Code, Codex, or CCR) downloads the files and can reference them during execution
File names are sanitized and indexed (e.g., 01-screenshot.png, 02-spec.md) to ensure consistent ordering and compatibility across operating systems.
Files are stored securely in Supabase storage and accessed via short-lived signed URLs. They are scoped to your workspace and not shared externally.