# Integración con macOS

> Las partes de Mariner que salen de la ventana — sincronización con iCloud, Atajos y Siri, Spotlight, el historial de peticiones, el proxy de toda la app y el techo de descarga.

## Sincronización con iCloud

Apagada por defecto. Actívala en <kbd>⌘,</kbd> → **iCloud** y relanza la app.

- **Se sincroniza:** workspaces, colecciones, carpetas, peticiones y entornos, a través de tu base de datos privada de iCloud. No interviene ningún servidor de Mariner.
- **Nunca se sincroniza:** el historial y los bodies de respuesta, que quedan en un almacén local, y las credenciales, que quedan en el Llavero de cada Mac.

El icono de nube en la barra de estado indica la situación: verde cuando está conectado, *iCloud off*, *Sync error*, o *Not syncing* cuando un cambio local lleva demasiado tiempo sin confirmación. Haz clic para ver el último guardado local, el último evento de iCloud y los cambios pendientes; **Sync now** ahí o <kbd>⌘S</kbd> en cualquier sitio fuerza un envío. Si iCloud no puede inicializarse al arrancar, Mariner sigue funcionando en local, apaga el interruptor y muestra el motivo en Ajustes.

## Atajos y Siri

Mariner ofrece la acción **Run Request** para la app Atajos: elige una petición guardada y se ejecuta con el entorno activo del workspace — incluso con Mariner cerrado — devolviendo el body de la respuesta (hasta 2 KB) como valor que la siguiente acción puede usar. Siri entiende frases como *"Run ‹request› in Mariner"* y *"Send ‹request› with Mariner"* para las peticiones que hayas habilitado en Atajos.

## Spotlight

Todas las peticiones se indexan. Escribe su nombre en Spotlight y el resultado abre la petición en Mariner.

## Historial

<kbd>⌘⇧H</kbd> abre el historial del workspace actual: cada ejecución con su estado, duración, la petición tal como se envió y la respuesta.

- Filtra por clase de estado (2xx … 5xx, errores), por colección o por texto sobre nombre y URL.
- Clic derecho sobre una fila: **Re-run** (con la definición actual de la petición), **Open Request**, **Copy URL**, **Delete**.
- **Retention** mantiene una ventana deslizante por workspace — 200 ejecuciones por defecto, ajustable de 10 a 10.000 — y **Purge Now** la aplica de inmediato. **Clear All** borra lo que está filtrado en ese momento.
- **Export HAR** escribe las ejecuciones filtradas como un archivo HAR 1.2 para las herramientas que lo leen.

Los bodies de respuesta se guardan hasta 1 MB cada uno; lo que sobra se descarta y se marca como recortado. Las últimas cinco ejecuciones están también a un <kbd>⌘K</kbd> bajo *Recent*.

## Proxy

<kbd>⌘,</kbd> → **Network** → **Use a proxy**, con host y puerto, una comprobación de alcance en vivo y una lista de **exclusiones** (`localhost, 127.0.0.1, *.local`; un punto inicial como `.example.com` cubre todos los subdominios). Un solo proxy atiende HTTP y HTTPS para toda la app.

<kbd>⌘⇧P</kbd> lo activa o desactiva sin abrir Ajustes; un chip en la barra de URL indica cuándo el tráfico pasa por él. Las peticiones usan un timeout de 30 segundos.

Cuando el fallo es del proxy y no del servidor, Mariner lo dice en vez de echarle la culpa a la red: **Proxy connection failed** — nombrando host y puerto cuando el proxy es el que configuraste aquí, y apuntando a los Ajustes del sistema cuando no lo es —, **Proxy rejected the credentials** (Mariner todavía no envía credenciales de proxy), **Proxy refused the tunnel** cuando responde al `CONNECT` con algo que no es un túnel, y **Proxy configuration failed** cuando no se puede leer el archivo PAC. Antes esto llegaba como un `kCFErrorDomainCFNetwork 310` en crudo, o como un error de TLS que señalaba un certificado que nunca se llegó a ver.

## Techo de descarga

<kbd>⌘,</kbd> → **Network** también limita cuánto cuerpo de respuesta se trae Mariner a memoria: **50 MB** por defecto, ajustable a 10, 25, 100 o 250 MB, o desactivado para quien sabe que está descargando algo grande a propósito.

Es el único límite que actúa *antes* de que los bytes existan — el cuerpo llega por trozos y la transferencia se corta en cuanto se pasa, así que un endpoint de 2 GB no puede hacer que la app le pida 2 GB al sistema. Los demás tamaños de esta página (el 1 MB por cuerpo del historial, los topes del visor) protegen el disco o el render, y para cuando entran en juego la respuesta ya está en memoria.

## Registro de exploración

Un pequeño diario opcional de hitos — primer 2xx, primer error, una respuesta por debajo de 100 ms — en **Ayuda → Registro de exploración**. Desactiva el seguimiento en **Ajustes → Apariencia** si prefieres no tenerlo.

---
Source: https://marinerhttp.dev/es/docs/system · Mariner docs
