# Instrucciones para el agente: MultiMail CLI: revisa buzones y correos pendientes de aprobación

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/social-and-messaging/multimail
- Guía completa: https://lab.wisd.ai/hub/multimail-cli

---

## 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: prepara el acceso

Comprueba que tienes Node.js ≥22.20.0 y npm/npx, Go ≥1.26.10 y el directorio de binarios en PATH. El catálogo acepta Node ≥20, pero instala también la [CLI skills](https://github.com/vercel-labs/skills/blob/main/package.json), que exige ≥22.20.0. Go se exige por el [instalador](https://github.com/mvanhorn/printing-press-library/blob/main/npm/src/commands/install.ts), con versión fijada en [`.go-version`](https://github.com/mvanhorn/printing-press-library/blob/main/.go-version). Obtén un token del entorno de pruebas elegido; se configurará después de instalar.

### Paso 2: instala la CLI

Ejecuta el comando de instalación del README:

```bash
npx -y @mvanhorn/printing-press-library install multimail
```

El resultado es `multimail-pp-cli` y la skill `pp-multimail`. Comprueba que la carpeta indicada por el instalador está en PATH: por defecto `~/.local/bin` en macOS/Linux o `%LOCALAPPDATA%\Programs\PrintingPress\bin` en Windows. Si falta, aplica la línea que imprima el instalador y abre una terminal nueva.

### Paso 3: autentica y prueba el flujo documentado

Configura `MULTIMAIL_BEARER_AUTH` como variable de entorno privada de esta terminal. El [código de configuración](https://github.com/mvanhorn/printing-press-library/blob/main/library/social-and-messaging/multimail/internal/config/config.go) usa `https://api.multimail.dev` por defecto. Si tu entorno tiene otra dirección oficial, fija `MULTIMAIL_BASE_URL` a esa dirección antes de llamar: el prefijo del token no selecciona por sí solo otro servidor. Comprueba destino y token antes de sincronizar correos.

Ejecuta los comandos en este orden. Los términos, dominios e identificadores de ejemplo se sustituyen por los que correspondan a tu trabajo.

```bash
multimail-pp-cli doctor --dry-run
multimail-pp-cli sync --resources mailboxes,emails --since 7d
multimail-pp-cli oversight list --json
```

## Comprobación

Comprueba que cada comando termina correctamente y que la salida corresponde a la cuenta, fuente o datos que seleccionaste. Una lista vacía no demuestra que el dato no exista: comprueba primero el alcance de la consulta y, si usas una copia local, su sincronización.

## Si algo falla

Si la búsqueda no encuentra mensajes, comprueba los recursos sincronizados y su ventana temporal. Un 404 al revisar una decisión puede indicar que ya fue resuelta. Consulta el [README de esta CLI](https://github.com/mvanhorn/printing-press-library/blob/main/library/social-and-messaging/multimail/README.md) para las opciones específicas de tu sistema y versión. No compartas credenciales en la salida de diagnóstico.