# Instrucciones para el agente: Notion CLI: consulta y revisa tu espacio desde una copia local

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/productivity/notion
- Guía completa: https://lab.wisd.ai/hub/notion-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 accesible por PATH ([metadatos del instalador](https://github.com/mvanhorn/printing-press-library/blob/main/npm/package.json)). Crea una integración interna y comparte con ella las bases de prueba. Guarda su token en la variable privada `NOTION_TOKEN` para el paso de autenticación.

### Paso 2: instala la CLI

El [instalador](https://github.com/mvanhorn/printing-press-library/blob/main/npm/src/commands/install.ts) compila con Go; [`.go-version`](https://github.com/mvanhorn/printing-press-library/blob/main/.go-version) fija 1.26.10. Node ≥22.20.0 es necesario para la CLI skills invocada tras compilar, aunque el catálogo acepte ≥20. Ejecuta el comando del README:

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

Quedan instalados `notion-pp-cli` y su skill. El directorio por defecto es `~/.local/bin` en macOS/Linux o `%LOCALAPPDATA%\Programs\PrintingPress\bin` en Windows. Si no está en PATH, aplica la línea específica que imprima el instalador y abre una terminal nueva.

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

Después de instalar, guarda el token con el comando del inicio rápido:

```bash
notion-pp-cli auth set-token "$NOTION_TOKEN"
```

El README usa `NOTION_TOKEN` como entrada para este comando y `NOTION_BEARER_AUTH` en su tabla de configuración; esta ruta conserva el token mediante `auth set-token`.

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

```bash
notion-pp-cli sync --full
notion-pp-cli stale --days 30 --json
notion-pp-cli changed --since 7d --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 aparece object not found, comprueba que la integración tenga acceso a la base. Si las consultas locales no devuelven datos, completa primero la sincronización. Consulta el [README de esta CLI](https://github.com/mvanhorn/printing-press-library/blob/main/library/productivity/notion/README.md) para las opciones específicas de tu sistema y versión. No compartas credenciales en la salida de diagnóstico.