Clarity CLI: prepara etiquetas y revisa la instrumentación de tu web

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/marketing/clarity
• Guía completa: https://lab.wisd.ai/hub/clarity-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, npm/npx y Go ≥1.26.10 disponibles, y que el directorio de binarios queda en PATH. El instalador del catálogo usa Go para compilar y la CLI skills para las instrucciones del agente; el mínimo Node cubre ambas fases. Localiza el identificador de tu proyecto de Clarity y un archivo HTML existente; sustituirán abc123 y ./index.html en los ejemplos.

Paso 2: instala la CLI

Ejecuta el comando de instalación del README:

npx -y @mvanhorn/printing-press-library install clarity

Paso 3: prueba el flujo documentado

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

clarity-pp-cli snippet install abc123 --format html

Inserta el fragmento generado en ./index.html antes de auditar ese archivo:

clarity-pp-cli audit html ./index.html --json --select found_project_id,calls

Comprobación

Comprueba que found_project_id coincide con tu proyecto.

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 no aparecen sesiones, comprueba el proyecto y las peticiones de recogida en el navegador. Revisa también los atributos de enmascarado si la visibilidad del contenido no coincide con lo esperado. Consulta el README de esta CLI para las opciones específicas de tu sistema y versión. No compartas credenciales en la salida de diagnóstico.