Get data into Studio and results out. Upload CSVs, PDFs, and documents to give the AI context for analysis; download the reports, presentations, and datasets it generates — all stored server-side and accessible from any device.
The AI processes uploaded files inside the server-side sandbox. Files are stored per-chat and accessible through the Files panel. Your local filesystem is never accessed.
Move files between your local device and Studio's server-side environment so the AI can analyze your data and you can export its output.
- Signed in to Treasure AI Studio (Getting Started)
- An active chat session
The maximum file size for uploads is 100 MB per file. If you need to work with larger files, consider splitting them into smaller chunks or uploading only the relevant portions.
You can upload files to a chat session in two ways: through the chat input or through the Files panel.
- Click the plus button (+) in the chat input toolbar
- Select one or more files from the file picker
- Files appear as thumbnails below the text area, showing the file name and a category icon
- Type your message (e.g., "Summarize this report" or "Load this CSV into a table")
- Click Send — the files upload and your message is sent together
You can also drag and drop files directly onto the chat area. When you drag a file over the chat, a blue overlay appears with the message "Drop files here". Release to add the files to your pending attachments.
To remove a pending file before sending, click the X button on its thumbnail.
- Tap the plus button (+) in the chat input toolbar
- Choose from:
- File — Browse and select documents
- Camera — Take a photo to attach
- Photos — Select from your photo library
- Files appear as pills below the text area
- Type your message and tap Send
To remove a pending file, tap the X on its pill.
- Open the Files panel by clicking the folder icon in the chat header
- Click the Upload button at the top of the panel
- Select a file from the file picker
- The file uploads to the current directory
When you have files attached in the chat input, a directory path input appears. This lets you specify which folder the files should be uploaded to within the chat's file system.
- The default location is the root directory (shown as "(root)")
- Start typing a path to see autocomplete suggestions from existing folders
- Select an existing folder or type a new path to create one
Each chat session has its own isolated file system rooted at /home/agent/chats/{chatId}. Files uploaded through the chat input are stored at the specified directory path within this root. The directory path input uses autocomplete based on the current folder tree.
When the AI creates a file (a report, spreadsheet, presentation, or other output), a "Created file" card appears in the chat with:
- File icon — Color-coded by category (green for spreadsheets, blue for documents, purple for images, etc.)
- File name and file size
- Category label (e.g., "Spreadsheet", "Document", "Presentation")
- Preview button — Opens the file in the built-in viewer
- Download button — Downloads the file to your device
- Open the Files panel (folder icon in the chat header)
- Hover over any file in the file tree
- Click the download icon that appears on hover
Or, when viewing a file in the viewer:
- Click the Download button in the viewer footer
Tap the Preview button (eye icon) on any file card to open it. Download functionality on mobile is handled through the iOS share sheet when previewing files.
The Files panel is your file manager within each chat session. It has two zones:
A hierarchical folder tree showing all files in the current chat session.
- Folders display with a folder icon and expand/collapse on click
- Files display with a category-colored icon, name, and size
- Hover over a file to see the download button
- Click a file to open it in the viewer (Zone B)
When no files exist yet, the panel shows: "No files yet" with the hint "Upload files or ask the AI to generate them".
A tabbed viewer area where opened files display. Each open file gets its own tab:
- Tab bar — Shows file name with a colored dot indicator; click X to close a tab
- Viewer area — Renders the file using the appropriate viewer (see File Viewers)
- Fullscreen toggle — Expand the viewer to fill the screen
When no file is selected, the viewer shows: "Select a tab to view file".
| Control | Description |
|---|---|
| Folder icon (chat header) | Toggle the Files panel open/closed. A dot badge appears when files exist but the panel is closed |
| Reload button (refresh icon) | Refresh the file list from the server |
| Upload button | Upload a file to the current directory |
| Fullscreen / Exit fullscreen | Expand or collapse the viewer to fill the screen |
Work folders expose their files directly, so you can browse, rename, move, upload, and delete them from the sidebar and a dedicated work folder page — without opening a chat. Every work folder keeps its own file space, shared by every chat inside it; a standalone chat instead keeps its files in the per-chat Files panel described above. File management is available on Web and Desktop.
In the Work Folders section of the sidebar, click the chevron next to a work folder to expand it. Each expanded work folder lists its Chats and its Files — the work folder's file tree, loaded on demand.
Dotfiles and the work folder's CLAUDE.md are dimmed and sorted last. Click any file to open it in a viewer; use Refresh files to reload the tree from the server. Because the tree lives in the sidebar, you can inspect a work folder's files without starting a conversation.
Click a work folder's name in the sidebar to open its page. The page gives a semantic view of everything in the work folder, organized into sections:
| Section | Contents |
|---|---|
| Instruction | The standing guidance the AI follows in every chat here, saved as CLAUDE.md. See Core Concepts. |
| Files | The work folder's files and folders, in a table showing Name, Updated, and Size. |
| Local Skills | Skills defined inside the work folder under .claude/skills/, listed by name and description. |
| Chats | The conversations started in this work folder. Start a new one with the compose button. |
In the Files section, click a folder's chevron to expand it inline, or click the folder name to drill into it — the breadcrumb, rooted at Work Folders, tracks where you are. Clicking a file opens it in the full file view.
From the work folder page you can organize a work folder's files directly:
| Action | How |
|---|---|
| Upload | Click Upload to add files to the folder you're currently viewing. |
| New folder | Click New folder and enter a name. Names cannot contain / or be . or ... |
| Rename | Open a file or folder's ⋯ menu and choose Rename. |
| Move | Drag a file or folder onto another folder to move it. Moves stay within a single work folder — you cannot drag files between work folders. |
| Delete | Open the ⋯ menu and choose Delete. You can delete files and folders; deleting a folder also removes everything inside it, so Studio shows the item count and asks you to confirm first. |
| Ask AI | Click Ask AI (the ✨ button) on a file or folder to start a new chat in that work folder with the path pre-filled in the composer. |
File organization applies to work folders. A standalone chat keeps its files in the per-chat Files panel and is not browsable from the sidebar file tree.
Studio categorizes files by extension and displays them with color-coded icons:
| Category | Extensions | Icon Color |
|---|---|---|
| Spreadsheet | csv, xlsx, xls, tsv | Green |
| Document | md, txt, pdf, doc, docx, html, htm | Blue |
| Presentation | pptx, ppt | Blue |
| Image | png, jpg, jpeg, gif, svg, webp | Purple |
| Code | js, ts, py, sql, sh, yaml, yml | Orange |
| Data | json, xml, mmd, mermaid | Blue |
| Journey | *.journey.yaml, *.journey.yml | Teal |
| File | All other extensions | Gray |
If a file upload fails, you see the message: "File upload failed. Message not sent." The message is not sent to the AI when all file uploads fail.
If some files in a batch succeed and others fail, the message is sent with only the successfully uploaded files.
Files stored in Studio are subject to the following retention rules:
| Scenario | What Happens to Files |
|---|---|
| Standalone chat deleted | All files associated with that chat are permanently deleted |
| Work folder chat deleted | Files are not deleted. They remain accessible in the work folder workspace |
| Automatic expiration | Files in standalone chats are automatically deleted after the configured chat retention period (default: 28 days). Files in work folder chats are not deleted |
File deletion is permanent and cannot be undone. Download any files you need before deleting a standalone chat or before the retention period expires.
- Attach a file via the plus button and see it appear as a thumbnail/pill
- Send a message with the file and see the AI reference its contents
- Download an AI-generated file using the Download button on a "Created file" card
| Issue | Solution |
|---|---|
| "File upload failed. Message not sent." | Check your network connection and try again. Files must be under 100 MB — if larger, split the file or upload only the relevant section |
| Uploaded file not referenced by AI | The AI processes file contents asynchronously. Wait for the upload indicator to complete, then re-send your message |
| Download button not visible | Only AI-generated files show a Download button on the "Created file" card. Uploaded files can be downloaded from the Files panel |
- File Viewers — How Studio renders PDFs, spreadsheets, presentations, and more
- AI Chat Interface — Sending messages with file context
- Artifact Output — AI-generated output files (PPTX, DOCX, PDF, XLSX)
- Chat Data Retention — Configuring how long chat history and associated files are retained