# Instrucciones para el agente: Supermemory Admin CLI: inspecciona recuerdos por proyecto

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/supermemory-admin
- Guía completa: https://lab.wisd.ai/hub/supermemory-admin-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 Node.js ≥22.20.0 y npm/npx para instalar el binario y la skill, y el directorio de binarios en PATH: `~/.local/bin` en macOS/Linux o `%LOCALAPPDATA%\Programs\PrintingPress\bin` en Windows. Comprueba acceso al proyecto de Supermemory que vas a inspeccionar. Configura el token después de instalar.

Para instalar el binario, comprueba además Go ≥1.26.10, versión de [.go-version](https://github.com/mvanhorn/printing-press-library/blob/main/.go-version) que exige el [instalador](https://github.com/mvanhorn/printing-press-library/blob/main/npm/README.md#requirements). El instalador compila con go install; si no tienes Go, utiliza la publicación precompilada de la CLI siguiendo su README. Listar y buscar en el catálogo no requieren compilar.

### Paso 2: instala la CLI

Ejecuta el comando de instalación del README:

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

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

Configura SUPERMEMORY_ADMIN_TOKEN y, si corresponde, SUPERMEMORY_ADMIN_PROJECT en el entorno del proceso. El destino predeterminado es `https://api.supermemory.ai`, según su configuración. `SUPERMEMORY_ADMIN_PROJECT` selecciona proyecto por cabecera; `--container-tag` selecciona una etiqueta de contenedor y no es ese mismo ID. Sustituye project_123 por una etiqueta de contenedor real.

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

```bash
supermemory-admin-pp-cli doctor --agent
supermemory-admin-pp-cli supermemory-recall --q "contexto de despliegue" --agent --dry-run
supermemory-admin-pp-cli profiles --container-tag project_123 --agent --dry-run
```

Tras revisar la petición, ejecuta una lectura real sobre recuerdos de ensayo ya presentes:

```bash
supermemory-admin-pp-cli supermemory-recall --q "contexto de despliegue" --agent
```

Compara un recuerdo y su identificador con el panel del proyecto. Si no hay recuerdos, prepara uno de ensayo en el panel antes de repetir; una respuesta vacía no valida la recuperación.

## Comprobación

Comprueba que doctor reconoce la configuración. Las dos operaciones con --dry-run solo muestran las peticiones preparadas: revisa el proyecto, la consulta y la etiqueta sin esperar recuerdos reales ni dar por validada la recuperación.

## Si algo falla

Si falla el acceso, comprueba token y proyecto. En este ejemplo --dry-run evita la llamada de recuperación: no esperes documentos reales en esa salida. Consulta el [README de esta CLI](https://github.com/mvanhorn/printing-press-library/blob/main/library/productivity/supermemory-admin/README.md) para las opciones específicas de tu sistema y versión. No compartas credenciales en la salida de diagnóstico.