# Instrucciones para el agente: Agent Capture: obtiene evidencias visuales de ventanas de macOS

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/mvanhorn/printing-press-library/tree/main/library/developer-tools/agent-capture
- Guía completa: https://lab.wisd.ai/hub/agent-capture

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: comprueba el sistema

Comprueba que usas macOS 12.3 o posterior, que Xcode Command Line Tools está instalado y que Node.js ≥20 con npm/npx y Go ≥1.26.10 están disponibles para el instalador del catálogo. El mínimo Node corresponde al [catálogo](https://github.com/mvanhorn/printing-press-library/blob/main/npm/README.md#requirements); `--cli-only` evita la CLI de skills, pero compila el binario con Go, cuya versión consta en [.go-version](https://github.com/mvanhorn/printing-press-library/blob/main/.go-version). Estas instrucciones cubren la instalación y una primera captura estática. No necesitas claves de API.

### Paso 2: instala y verifica el ejecutable

La skill oficial documenta estos comandos:

```bash
npx -y @mvanhorn/printing-press-library install agent-capture --cli-only
agent-capture-pp-cli --version
```

Comprueba que el directorio de instalación está en el PATH de la terminal que usará el agente.

### Paso 3: prepara los permisos y la captura

Concede el permiso en Ajustes del Sistema → Privacidad y seguridad → Grabación de pantalla para tu terminal y reiníciala completamente.

Adaptamos el nombre corto del README al binario real del instalador. Abre Finder con una ventana de prueba sin datos privados y ejecuta:

```bash
agent-capture-pp-cli doctor
agent-capture-pp-cli list windows --json
agent-capture-pp-cli screenshot --app "Finder" --json /tmp/shot.png
```

El último comando debe crear `/tmp/shot.png`.

## Comprobación

La versión debe responder sin command not found. Comprueba con `doctor` los permisos y el entorno, la lista de ventanas y la captura `/tmp/shot.png`. Abre el archivo resultante y verifica que muestra el destino elegido.

## Si algo falla

Si la lista de ventanas está vacía, revisa el permiso y reinicia la terminal. Si falta el binario, revisa el PATH. ffmpeg no es necesario para la primera captura estática. Consulta la [skill oficial](https://github.com/mvanhorn/printing-press-library/blob/main/cli-skills/pp-agent-capture/SKILL.md) y el [README](https://github.com/mvanhorn/printing-press-library/blob/main/library/developer-tools/agent-capture/README.md) si sigue habiendo discrepancias entre nombres o versiones.