Файлы, скриншоты и фото

Покажите агенту баг так же, как показали бы коллеге: вставьте скриншот, и агент получит путь к картинке и прочитает её. В обратную сторону файлы ходят так же легко. Щёлкните по пути, который напечатал агент, и файл откроется в просмотрщике поверх терминала: его можно прочитать, скачать или отдать по ссылке.

Вставляйте скриншоты агенту

Скопируйте скриншот и нажмите ⌘V или Ctrl+V в терминале. Картинка загрузится в /uploads/clipboard/ этого терминала, а путь к ней вставится у курсора; Claude Code, Codex и OpenCode превращают этот путь во вложенную картинку.

Картинки до 20 MB уходят агенту картинкой; картинка больше загружается файлом.
Картинка становится WebP не больше 2500 px по длинной стороне, ровно под размер, который читают агенты: файл выходит в разы меньше скриншота, а деталей для агента столько же. Где WebP недоступен, картинка уходит в JPEG, а если преобразование её не уменьшит, отправляется оригинал.
Файл, скопированный в Finder или Проводнике, вставляется так же: ⌘V загружает сам файл.
Собственная вставка картинок в Claude Code тоже работает: нажмите Ctrl+V внутри Claude Code, и он найдёт только что вставленную картинку.

При первой вставке браузер может спросить доступ к буферу обмена; терминал подскажет, что запрос появился у адресной строки. Если браузер не даёт сайту буфер обмена, разрешите доступ в настройках сайта и вставьте снова.

Перетаскивайте файлы на терминал

Перетащите файлы с компьютера на терминал; он покажет «Перетащите для загрузки в этот терминал».

Файлы до лимита вашего тарифа: 100 MB на Start, 250 MB на Pro, 500 MB на Max, 1 GB на Business, 2 GB на Business Plus, 5 GB на Business Max, 10 GB на Business Ultra.
Файлы идут прямо в терминал, частями. Если связь оборвалась, загрузка ждёт и продолжает с последней дошедшей части, ничего не начиная заново.
Перетащите несколько файлов сразу: их пути вставятся одной строкой через пробел. Если в именах есть специальные символы, они будут экранированы для шелла.
Картинки до 20 MB ложатся к вставленным в /uploads/clipboard/. Остальные файлы попадают в /uploads/ под своими именами; второй файл с тем же именем становится name (1).ext.
Папку загрузить нельзя: упакуйте её в zip и перетащите архив или перетащите файлы из неё.

Отправляйте фото с телефона

Нажмите Вставить фото на панели клавиш под терминалом. Телефон предложит галерею, камеру и файлы; выберите одно фото или несколько.

Фото с iPhone в HEIC по дороге превращается в JPEG: HEIC не читает ни один агент. AVIF, BMP и TIFF становятся PNG.
Фото больше 4096 × 4096 уменьшается до этого размера.
Фото, которое браузер не может преобразовать, остаётся на телефоне, и терминал скажет, какое именно.

Кнопка Вставить на панели клавиш тоже вставляет картинку из буфера обмена телефона. Остальную панель клавиш описывает раздел Телефон.

Следите за загрузкой и отменяйте её

Плашка над терминалом показывает «Вставляем картинку…» или «Загружаем report.pdf…» и прогресс в процентах. Нажмите Esc или Отмена, чтобы остановить загрузку; уже отправленная часть удаляется из терминала. За раз идёт одно перетаскивание, по три файла одновременно. Пока связи нет, плашка пишет «Связь пропала. Продолжим с того же места…», и загрузка продолжится сама, как только сеть вернётся.

Где лежат загрузки

Загрузки видит только этот терминал, и они пропадают, когда он завершается или перезапускается. Из вставленных картинок хранятся 50 самых новых за последние 24 часа: каждая новая вставка убирает более старые. Чтобы сохранить файл, перенесите его в проект.

Открывайте пути к файлам из вывода

Пути, которые печатает агент, становятся ссылками, как только файл существует: при наведении они подчёркиваются. Щёлкните по пути с ⌘ или Ctrl или коснитесь его на телефоне.

Абсолютные пути, ~/…, ./…, ../… и пути вроде src/app.ts.
Суффикс :line или :line:col, например src/app.ts:42, открывает файл на этой строке. Одиночное имя вроде app.ts становится ссылкой, если у него есть строка.
Относительные пути отсчитываются от папки, в которой шелл находится прямо сейчас.
Ссылки file:// и ссылки, которые печатает ls --hyperlink, тоже открываются в просмотрщике; веб-ссылки открываются в новой вкладке браузера.

Откройте любой файл по пути

Выберите Открыть файл… в командном меню ⌘K или на странице Файлы и превью терминала. Введите абсолютный путь, путь от домашней папки (~/…) или относительно папки терминала; добавьте :line, чтобы перейти к строке.

Читайте файлы в просмотрщике

Просмотрщик открывается поверх терминала, а на телефоне занимает весь экран. В его шапке видны папка файла, размер и время изменения, а Esc его закрывает.

Код с номерами строк и подсветкой для 25 языков, среди них Dockerfile и Makefile; ссылка с :line прокручивает к этой строке и выделяет её.
Markdown, отрисованный так, как его показывает GitHub. Сырой HTML внутри пропускается, а вместо картинок показывается их alt-текст.
Картинки и PDF. Если телефон показывает только первую страницу PDF, нажмите Открыть в новой вкладке.
CSV и TSV в виде таблицы, первые 1000 строк.
Длинные логи: файл больше 1 MB открывается на последних 256 KB, а Загрузить строки раньше читает назад по 256 KB.
HTML как исходник, с кнопкой Открыть страницей, чтобы увидеть саму страницу.
Всё остальное: размер и тип, с кнопкой Скачать.

На пути к папке просмотрщик пишет «Это папка» и предлагает Открыть на files-хосте, где будет список до 2000 записей.

Просмотрщик показывает файлы до 20 MB, а через Скачать уходят файлы до 1 GiB. Скопировать путь копирует абсолютный путь.

Поделитесь файлом по ссылке

Откройте файл в просмотрщике и нажмите Поделиться ссылкой.
В блоке Ссылка работает выберите 15 минут, 1 час, 1 день или 7 дней.
Нажмите Создать ссылку, затем Скопировать ссылку.

Любой, у кого есть ссылка, может скачать этот файл без аккаунта, пока не выйдет срок. Страница Файлы и превью терминала перечисляет его ссылки в блоке Файлы по ссылке: сколько раз открыли каждую (наведите на число, чтобы увидеть время последнего открытия), когда она истекает, кнопку, чтобы скопировать её снова, и Отозвать, чтобы закрыть её раньше срока. У терминала может быть до 50 действующих ссылок. Ссылки переживают перезапуск и заканчиваются вместе с терминалом.

Открывайте свои файлы в браузере

У каждого терминала есть файловый адрес: https://files-<terminal ID>.detachbox.dev/<absolute path>. Он отдаёт то, что может прочитать этот терминал, со входом как у превью. Открыть страницей показывает оттуда HTML-отчёт или собранный сайт как страницу. Такая страница видит только файлы в своей папке и никогда не получает файлы с именем на точку, например .env, .git или .detachbox.