# Integração com o macOS > As partes do Mariner que saem da janela — sincronização com o iCloud, Atalhos e Siri, Spotlight, o histórico de requisições, o proxy de todo o app e o teto de download. ## Sincronização com o iCloud Desligada por padrão. Ative em ⌘, → **iCloud** e reinicie o app. - **Sincroniza:** workspaces, coleções, pastas, requisições e ambientes, pelo seu banco privado do iCloud. Nenhum servidor do Mariner entra no meio. - **Nunca sincroniza:** o histórico e os bodies de resposta, que ficam em um armazenamento local, e as credenciais, que ficam nas Chaves de cada Mac. O ícone de nuvem na barra de status indica a situação: verde quando está conectado, *iCloud off*, *Sync error*, ou *Not syncing* quando uma mudança local passa tempo demais sem confirmação. Clique para ver o último salvamento local, o último evento do iCloud e as mudanças pendentes; **Sync now** ali ou ⌘S em qualquer lugar força um envio. Se o iCloud não conseguir inicializar no início, o Mariner continua funcionando local, desliga o interruptor e mostra o motivo nos Ajustes. ## Atalhos e Siri O Mariner oferece a ação **Run Request** para o app Atalhos: escolha uma requisição salva e ela roda com o ambiente ativo do workspace — mesmo com o Mariner fechado — devolvendo o body da resposta (até 2 KB) como valor que a próxima ação pode usar. A Siri entende frases como *"Run ‹request› in Mariner"* e *"Send ‹request› with Mariner"* para as requisições que você habilitou no Atalhos. ## Spotlight Todas as requisições são indexadas. Digite o nome no Spotlight e o resultado abre a requisição no Mariner. ## Histórico ⌘⇧H abre o histórico do workspace atual: cada execução com seu status, duração, a requisição do jeito que foi enviada e a resposta. - Filtre por classe de status (2xx … 5xx, erros), por coleção ou por texto sobre nome e URL. - Botão direito em uma linha: **Re-run** (com a definição atual da requisição), **Open Request**, **Copy URL**, **Delete**. - **Retention** mantém uma janela deslizante por workspace — 200 execuções por padrão, ajustável de 10 a 10.000 — e **Purge Now** aplica na hora. **Clear All** apaga o que está filtrado naquele momento. - **Export HAR** escreve as execuções filtradas como um arquivo HAR 1.2 para as ferramentas que o leem. Os bodies de resposta são guardados até 1 MB cada; o que passa disso é descartado e marcado como cortado. As últimas cinco execuções também estão a um ⌘K em *Recent*. ## Proxy ⌘, → **Network** → **Use a proxy**, com host e porta, uma verificação de alcance ao vivo e uma lista de **exceções** (`localhost, 127.0.0.1, *.local`; um ponto inicial como `.example.com` cobre todos os subdomínios). Um único proxy atende HTTP e HTTPS para o app inteiro. ⌘⇧P liga ou desliga sem abrir os Ajustes; um chip na barra de URL indica quando o tráfego passa por ele. As requisições usam um timeout de 30 segundos. Quando a falha é do proxy e não do servidor, o Mariner diz isso em vez de culpar a rede: **Proxy connection failed** — nomeando host e porta quando o proxy é o que você configurou aqui, e apontando para os Ajustes do sistema quando não é —, **Proxy rejected the credentials** (o Mariner ainda não envia credenciais de proxy), **Proxy refused the tunnel** quando ele responde ao `CONNECT` com algo que não é um túnel, e **Proxy configuration failed** quando o arquivo PAC não pode ser lido. Antes isso chegava como um `kCFErrorDomainCFNetwork 310` cru, ou como um erro de TLS apontando para um certificado que nunca chegou a ser visto. ## Teto de download ⌘, → **Network** também limita quanto de corpo de resposta o Mariner puxa para a memória: **50 MB** por padrão, ajustável para 10, 25, 100 ou 250 MB, ou desligado para quem sabe que está baixando algo grande de propósito. É o único limite que age *antes* de os bytes existirem — o corpo chega em pedaços e a transferência é cortada assim que passa, então um endpoint de 2 GB não consegue fazer o app pedir 2 GB ao sistema. Os outros tamanhos desta página (o 1 MB por corpo do histórico, os tetos do visualizador) protegem o disco ou a renderização, e quando eles entram em cena a resposta já está na memória. ## Registro de exploração Um pequeno diário opcional de marcos — primeiro 2xx, primeiro erro, uma resposta abaixo de 100 ms — em **Ajuda → Registro de exploração**. Desligue o acompanhamento em **Ajustes → Aparência** se preferir não ter. --- Source: https://marinerhttp.dev/pt-br/docs/system · Mariner docs