hwipit/plugin

Configura Hwip para el usuario. La configuración completa es instalar la CLI y luego ejecutar hwip install — todo lo demás en esta habilidad es verificación.

La configuración

npm install -g @hwip/cli
hwip install

El instalador es interactivo (inicio de sesión en el navegador + selector de agente), por lo que debe ejecutarse en la terminal del usuario, no a través de tu herramienta Bash. Pídeles que lo ejecuten — dentro de una sesión de Claude Code pueden escribirlo con un prefijo !:

! npm install -g @hwip/cli && hwip install

Instala globalmente, no con npx. hwip cc (manejar una sesión desde el teléfono) necesita hwip en el PATH, y los hooks que instala el instalador (como los hooks de este plugin y el servidor MCP) son command -v hwip || npx … — un binario global evita un arranque en frío de npx en cada notificación y cada inicio de sesión. npx -y @hwip/cli install sigue funcionando para una configuración solo de notificaciones sin control telefónico, pero por defecto usa la instalación global.

Lo que hace hwip install:

• Máquina nueva: abre un inicio de sesión en el navegador. La aplicación web emite una clave API y un Hook interactivo como un par emparejado, automáticamente — sin necesidad de copiar claves desde Configuración. La CLI guarda todo (apiKey, hookId, baseUrl, wsUrl) en ~/.hwip/config.json.
• Ya inició sesión: conserva las credenciales guardadas y solo (re)instala las integraciones del agente. Es seguro volver a ejecutarlo en cualquier momento.
• Instala hooks/MCP para cada agente detectado (Claude Code, Gemini CLI, Codex CLI, Cursor, …).

Verificación (después de que el usuario diga que terminó)

1. hwip verify (o npx -y @hwip/cli verify) — debe informar que la clave API y el hook están configurados. Nunca uses cat ~/.hwip/config.json: contiene la clave API, e imprimirla la deja en la transcripción.
2. Envía un push de prueba: usa hwip_notify o hwip notify --title "Hwip conectado ✅".
3. El teléfono vibra → listo. Dile al usuario que reinicie su sesión del agente para que el hook SessionStart inyecte las reglas de control remoto.

Reglas — NO reintroduzcas el flujo manual antiguo

• Fuente única de verdad: ~/.hwip/config.json. Cada componente de Hwip (CLI, servidor MCP, hooks del plugin) lo lee. NO añadas HWIP_API_KEY / HWIP_HOOK_ID a ~/.zshrc, ~/.bashrc o ~/.claude/settings.json — las exportaciones de shell son innecesarias y crean una segunda copia propensa a desincronizarse.
• Las variables de entorno existen solo como anulaciones avanzadas (multi-cuenta, CI). Nunca las sugieras durante la configuración normal.
• Nunca guíes al usuario para crear claves o hooks manualmente en la aplicación web a menos que la máquina no tenga navegador (ver más abajo).

Máquina sin navegador (headless)

Inicia sesión en cualquier máquina CON navegador. Luego, el usuario lee los dos valores (apiKey, hookId) del archivo ~/.hwip/config.json de esa máquina por su cuenta — no imprimas el archivo en la sesión, contiene la clave API. En la máquina headless, el usuario ejecuta esto en su propia terminal (ejecutado por ti, la clave quedaría en la transcripción):

npm install -g @hwip/cli
hwip install --key ak_... --hook hook_...

Si algo sale mal

hwip_ask 403 Prohibido — el emparejamiento clave/hook está desactualizado. Vuelve a ejecutar hwip install; un nuevo inicio de sesión emite un par consistente.

No se recibe notificación — command -v jq (los hooks necesitan jq: brew install jq / apt install jq), y confirma que la aplicación del teléfono haya iniciado sesión en la MISMA cuenta que usaste en el navegador.

hwip_ask agota el tiempo de espera — ¿la aplicación del teléfono está abierta? ¿Se respondió dentro del tiempo de espera (300 s por defecto)? hwip verify verifica el estado de la instalación.

config.json falta o está corrupto — vuelve a ejecutar hwip install; reescribe el archivo.