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.
Configure em um minuto
- 1
Instale o Recoly 0.9 ou mais recente
Baixe, mova para Aplicativos e abra uma vez.
- 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
Reinicie seu agente
Ele carrega o servidor MCP do Recoly. Experimente pedir uma captura da sua tela.
Pelo 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 · allAdiciona o comando recoly e depois registra o servidor MCP (veja a prévia antes com --dry-run).
Qualquer cliente MCP
{
"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_screenshot | Capture a tela, uma janela ou uma área — e veja a imagem. |
| recoly_record_start · recoly_record_stop | Grave a reprodução de um bug ou uma demo. Você vê os controles de gravação o tempo todo. |
| recoly_export | Renderize MP4, GIF, WebM ou ProRes com zoom automático, fundo, um preset salvo e qualquer proporção. |
| recoly_transcript | Transcrição Whisper no dispositivo, com marcações de tempo. |
| recoly_targets | Liste as telas e janelas que podem ser capturadas. |
| recoly_doctor | Verifique as permissões e receba a correção exata quando algo estiver faltando. |
| recoly_recordings_list · recoly_presets_list | Encontre 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.
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