Para desenvolvedores e agentes de IA

Deixe seu agente de IA ver, gravar e demonstrar seu Mac.

A ferramenta de linha de comando e o servidor MCP do Recoly dão ao Claude Code, Codex, Cursor e a qualquer cliente MCP um gravador de tela local: capturas que ele pode analisar, gravações para reproduzir bugs, vídeos de demo polidos e transcrições no dispositivo.

Grátis em todos os planosRoda localmente — sem contaClaude Code · Codex · Cursor

Configure em um minuto

  1. 1

    Instale o Recoly 0.9 ou mais recente

    Baixe, mova para Aplicativos e abra uma vez.

  2. 2

    Conecte seus agentes

    No Recoly, abra "Settings" (a engrenagem) → "Command line & AI agents" → "Connect Claude Code, Codex, Cursor". Ou use os comandos de Terminal abaixo.

  3. 3

    Reinicie seu agente

    Ele carrega o servidor MCP do Recoly. Experimente pedir uma captura da sua tela.

Pelo Terminal

Terminal
curl -fsSL https://recoly.app/install-cli.sh | sh
recoly agents install --target claude --dry-run
recoly agents install --target claude --yes   # or: codex · cursor · all

Adiciona o comando recoly e depois registra o servidor MCP (veja a prévia antes com --dry-run).

Qualquer cliente MCP

mcp.json
{
  "mcpServers": {
    "recoly": {
      "command": "/Applications/Recoly.app/Contents/Resources/native/bin/darwin-arm64/recoly",
      "args": ["mcp", "serve"]
    }
  }
}

Cole na configuração MCP do seu cliente. Obtenha o caminho exato para o seu Mac com recoly agents print-config.

Ou deixe seu agente fazer

Cole isto no Claude Code, Codex ou Cursor:

Leia https://recoly.app/agents e configure o servidor MCP do Recoly para mim. Mostre cada mudança de configuração e pergunte antes de aplicar.

O que seu agente pode fazer

recoly_screenshotCapture a tela, uma janela ou uma área — e veja a imagem.
recoly_record_start · recoly_record_stopGrave a reprodução de um bug ou uma demo. Você vê os controles de gravação o tempo todo.
recoly_exportRenderize MP4, GIF, WebM ou ProRes com zoom automático, fundo, um preset salvo e qualquer proporção.
recoly_transcriptTranscrição Whisper no dispositivo, com marcações de tempo.
recoly_targetsListe as telas e janelas que podem ser capturadas.
recoly_doctorVerifique as permissões e receba a correção exata quando algo estiver faltando.
recoly_recordings_list · recoly_presets_listEncontre gravações recentes e estilos salvos.

Coisas para pedir ao seu agente

  • “Reproduza o bug do checkout, grave e me dê um GIF para a issue.”
  • “Tire um screenshot e me diga por que este modal parece estranho.”
  • “Grave uma demo de 30 segundos da funcionalidade que você acabou de criar e exporte versões 16:9 e 9:16 com meu preset Brand.”
  • “Transcreva minha última gravação e liste os itens de ação.”
  • “Verifique se o Recoly tem as permissões de que precisa.”
  • “Exporte minha última gravação como um GIF de 720p.”

Seguro por design

  • Somente local: a CLI conversa com o app por um socket privado que só o seu usuário do macOS consegue abrir. Sem portas, sem nuvem, sem conta.
  • Você mantém o controle: desative o acesso de agentes em Settings quando quiser. Uma notificação aparece quando um agente começa a gravar, e ⌘⇧3 interrompe.
  • Os pedidos de aprovação do próprio agente continuam valendo para cada chamada de ferramenta.
  • Mudanças de configuração podem ser visualizadas antes com --dry-run, e o Recoly faz backup dos arquivos antes de alterá-los.
  • Seu plano se aplica: 4K, ProRes, WebM e qualidade Studio exigem Pro; exportações Free levam uma pequena marca d'água.

Linha de comando

Todo comando aceita --json. Os resultados vão para stdout e o progresso para stderr. Códigos de saída: 0 ok, 1 falha, 2 uso inválido.

Terminal
recoly doctor                      # permissions + fix hints
recoly targets                     # displays and windows
recoly screenshot --window window:1234:0 --output shot.png
recoly record start --window window:1234:0 --duration 30
recoly export --video ~/Movies/Recoly/recording-….mp4 --format gif --aspect 9:16
recoly transcript --video ~/Movies/Recoly/recording-….mp4
recoly guide --json                # the full, machine-readable contract
Recoly para agentes de IA — CLI e MCP para Claude Code, Codex e Cursor