detachbox
PáginasArchivos, capturas y fotos

Archivos, capturas y fotos

Enséñale un fallo al agente como se lo enseñarías a un compañero: pega la captura, y el agente recibe su ruta y la lee. Los archivos viajan igual de fácil en el otro sentido. Haz clic en una ruta que imprime el agente, y el archivo se abre en un visor sobre el terminal, listo para leerlo, descargarlo o compartirlo.

Pega capturas para el agente

Copia una captura y pulsa ⌘V o Ctrl+V en el terminal. La imagen se sube a /uploads/clipboard/ de este terminal y su ruta se pega en el cursor; Claude Code, Codex y OpenCode convierten esa ruta en una imagen adjunta.

  • Las imágenes de hasta 20 MB llegan al agente como imagen; una más grande se sube como archivo.
  • Las imágenes pasan a WebP de como máximo 2500 px en el lado largo, el tamaño que leen los agentes: varias veces más ligeras que la captura, con el mismo detalle para el agente. Donde no hay codificación WebP pasan a JPEG, y una imagen que la conversión no haría más pequeña va tal cual.
  • Un archivo copiado en Finder o en el Explorador se pega igual: ⌘V sube el propio archivo.
  • El pegado de imágenes de Claude Code también funciona: pulsa Ctrl+V dentro de Claude Code y encuentra la imagen que acabas de pegar.

En el primer pegado, el navegador puede pedir acceso al portapapeles; el terminal señala la solicitud junto a la barra de direcciones. Si el navegador bloquea el portapapeles para el sitio, permítelo en los ajustes del sitio y vuelve a pegar.

Suelta archivos en el terminal

Arrastra archivos desde tu computadora hasta el terminal; muestra «Suelta para subir a este terminal».

  • Archivos hasta el límite de tu plan: 100 MB en Start, 250 MB en Pro, 500 MB en Max, 1 GB en Business, 2 GB en Business Plus, 5 GB en Business Max, 10 GB en Business Ultra.
  • Los archivos van directos a tu terminal, por partes. Si se corta la conexión, la subida espera y sigue desde la última parte que llegó; nada empieza de cero.
  • Suelta varios a la vez: sus rutas se pegan en una línea, separadas por espacios y escapadas para el shell cuando un nombre lo necesita.
  • Las imágenes de hasta 20 MB se unen a las pegadas en /uploads/clipboard/. Los demás archivos llegan a /uploads/ con su propio nombre; un segundo archivo con el mismo nombre pasa a ser name (1).ext.
  • Una carpeta se rechaza: comprímela en zip y suelta el zip, o suelta los archivos que contiene.

Manda fotos desde el teléfono

Toca Pegar una foto en la barra de teclas bajo el terminal. El teléfono ofrece su galería de fotos, la cámara y sus archivos; elige una foto o varias.

  • Una foto de iPhone en HEIC se convierte en JPEG por el camino, porque ningún agente lee HEIC. AVIF, BMP y TIFF pasan a PNG.
  • Una foto de más de 4096 × 4096 se reduce para que quepa.
  • Una foto que el navegador no puede convertir se queda en el teléfono, y el terminal te dice cuál.

El botón Pegar de la barra de teclas también pega una imagen del portapapeles del teléfono. Teléfono cubre el resto de la barra de teclas.

Sigue y cancela una subida

Un indicador sobre el terminal muestra «Pegando la imagen…» o «Subiendo report.pdf…» con su progreso en porcentaje. Pulsa Esc o elige Cancelar para detener la subida; lo que ya se envió se borra del terminal. Se sube una sola tanda de archivos soltados cada vez, tres de ellos a la vez. Mientras no hay conexión, el indicador dice «Se perdió la conexión. Seguimos donde se quedó…», y la subida sigue sola en cuanto vuelves a tener conexión.

Dónde viven las subidas

Solo este terminal ve sus subidas, y se van cuando termina o se reinicia. De las imágenes pegadas se guardan las 50 más nuevas de las últimas 24 horas: cada pegado nuevo retira las más antiguas. Lleva un archivo a tu proyecto para conservarlo.

Abre rutas de archivos desde la salida

Las rutas que imprime el agente se vuelven enlaces en cuanto el archivo existe: se subrayan al pasar el puntero. Haz ⌘-clic o Ctrl-clic en una, o tócala en el teléfono.

  • Rutas absolutas, ~/…, ./…, ../… y rutas como src/app.ts.
  • Un sufijo :line o :line:col, como src/app.ts:42, abre el archivo en esa línea. Un nombre suelto como app.ts se enlaza cuando lleva una línea.
  • Las rutas relativas parten de la carpeta en la que está ahora el shell.
  • Los enlaces file:// y los que imprime ls --hyperlink también se abren en el visor; los enlaces web se abren en una pestaña nueva del navegador.

Abre cualquier archivo por su ruta

Elige Abrir archivo… en el menú de comandos ⌘K, o en la página Archivos y vistas previas del terminal. Escribe una ruta absoluta, una ruta desde tu carpeta personal (~/…) o una relativa a la carpeta del terminal; añade :line para saltar ahí.

Lee archivos en el visor

El visor se abre sobre el terminal; en el teléfono ocupa toda la pantalla. Su cabecera muestra la carpeta del archivo, su tamaño y cuándo cambió, y Esc lo cierra.

  • Código, con números de línea y resaltado para 25 lenguajes, entre ellos Dockerfiles y Makefiles; un enlace con :line se centra en esa línea y la marca.
  • Markdown, renderizado como lo muestra GitHub. El HTML en bruto que contenga se omite, y las imágenes aparecen como su texto alternativo.
  • Imágenes y PDF. En un teléfono que solo muestra la primera página de un PDF, elige Abrir en una pestaña nueva.
  • CSV y TSV como tabla, las primeras 1000 filas.
  • Logs largos: un archivo de más de 1 MB se abre en sus últimos 256 KB, y Cargar líneas anteriores lee hacia atrás de 256 KB en 256 KB.
  • HTML como código fuente, con Abrir como página para ver la página.
  • Cualquier otra cosa: su tamaño y su tipo, con Descargar.

Una ruta de carpeta dice «Esto es una carpeta», con Abrir en el host de archivos para un listado de hasta 2000 entradas.

El visor muestra archivos de hasta 20 MB, y Descargar admite archivos de hasta 1 GiB. Copiar ruta copia la ruta absoluta.

Comparte un archivo por enlace

  1. Abre el archivo en el visor y elige Compartir enlace.
  2. En El enlace funciona durante, elige 15 minutos, 1 hora, 1 día o 7 días.
  3. Elige Crear el enlace y después Copiar enlace.

Cualquiera con el enlace puede descargar ese archivo, sin necesidad de cuenta, hasta que se acabe su tiempo. La página Archivos y vistas previas del terminal lista sus enlaces en Archivos compartidos: cuántas veces se abrió cada uno (pasa el puntero por el número para ver la última vez), cuándo caduca, un botón para copiarlo de nuevo y Revocar para terminarlo antes. Un terminal admite hasta 50 enlaces activos. Sus enlaces sobreviven a un reinicio y terminan con el terminal.

Abre tus archivos en el navegador

Cada terminal tiene una dirección de archivos: https://files-<terminal ID>.detachbox.dev/<absolute path>. Sirve lo que ese terminal puede leer, con el mismo inicio de sesión que las vistas previas. Abrir como página muestra desde ahí un informe HTML o un sitio compilado como página. Una página así solo alcanza los archivos de su propia carpeta, y nunca archivos cuyo nombre empieza por un punto, como .env, .git o .detachbox.