Para desarrolladores y agentes de IA

Que tu agente de IA vea, grabe y haga demos de tu Mac.

La herramienta de línea de comandos y el servidor MCP de Recoly dan a Claude Code, Codex, Cursor y cualquier cliente MCP un grabador de pantalla local: capturas que puede mirar, grabaciones para reproducir errores, vídeos de demo pulidos y transcripciones en el dispositivo.

Gratis en todos los planesFunciona en local — sin cuentaClaude Code · Codex · Cursor

Configúralo en un minuto

  1. 1

    Instala Recoly 0.9 o posterior

    Descárgalo, muévelo a Aplicaciones y ábrelo una vez.

  2. 2

    Conecta tus agentes

    En Recoly, abre "Settings" (el engranaje) → "Command line & AI agents" → "Connect Claude Code, Codex, Cursor". O usa los comandos de Terminal de abajo.

  3. 3

    Reinicia tu agente

    Cargará el servidor MCP de Recoly. Prueba a pedirle una captura de tu pantalla.

Desde la 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

Añade el comando recoly y después registra el servidor MCP (previsualiza antes con --dry-run).

Cualquier cliente MCP

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

Pégalo en la configuración MCP de tu cliente. Obtén la ruta exacta para tu Mac con recoly agents print-config.

O deja que lo haga tu agente

Pega esto en Claude Code, Codex o Cursor:

Lee https://recoly.app/agents y configura el servidor MCP de Recoly por mí. Muéstrame cada cambio de configuración y pregúntame antes de aplicarlo.

Lo que puede hacer tu agente

recoly_screenshotCaptura la pantalla, una ventana o un área — y mira la imagen.
recoly_record_start · recoly_record_stopGraba la reproducción de un error o una demo. Ves los controles de grabación todo el tiempo.
recoly_exportExporta MP4, GIF, WebM o ProRes con zoom automático, fondo, un preset guardado y cualquier relación de aspecto.
recoly_transcriptTranscripción con Whisper en el dispositivo, con marcas de tiempo.
recoly_targetsLista las pantallas y ventanas que se pueden capturar.
recoly_doctorComprueba los permisos y da la solución exacta cuando falta alguno.
recoly_recordings_list · recoly_presets_listEncuentra grabaciones recientes y estilos guardados.

Cosas que pedirle a tu agente

  • “Reproduce el error del pago, grábalo y dame un GIF para la issue.”
  • “Haz una captura y dime por qué este modal se ve raro.”
  • “Graba una demo de 30 segundos de la función que acabas de crear y exporta versiones 16:9 y 9:16 con mi preset Brand.”
  • “Transcribe mi última grabación y enumera las tareas pendientes.”
  • “Comprueba si Recoly tiene los permisos que necesita.”
  • “Exporta mi última grabación como un GIF de 720p.”

Seguro por diseño

  • Solo local: la CLI habla con la app por un socket privado que solo puede abrir tu usuario de macOS. Sin puertos, sin nube, sin cuenta.
  • Tú tienes el control: desactiva el acceso de agentes en Settings cuando quieras. Aparece una notificación cuando un agente empieza a grabar, y ⌘⇧3 lo detiene.
  • Las solicitudes de aprobación de tu propio agente siguen aplicándose a cada llamada a una herramienta.
  • Los cambios de configuración se pueden previsualizar con --dry-run, y Recoly hace copia de los archivos antes de tocarlos.
  • Se aplica tu plan: 4K, ProRes, WebM y la calidad Studio requieren Pro; las exportaciones Free llevan una pequeña marca de agua.

Línea de comandos

Todos los comandos aceptan --json. Los resultados van a stdout y el progreso a stderr. Códigos de salida: 0 correcto, 1 fallo, 2 uso no vá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 y MCP para Claude Code, Codex y Cursor