Ir al contenido
moshpit
ES

Docs · Tema

Configurar un host

Configurar un host conecta los hooks de ciclo de vida de tus agentes de programación con Moshpit para que tu teléfono vea el estado de cada agente y reciba notificaciones push cifradas cuando un agente te necesite o termine un turno.

Moshpit nunca cambia nada en un host en silencio. Pide permiso antes de su primera instalación al conectarte, y puedes revisar, probar, reparar o quitar la configuración en cualquier momento:

  1. Conéctate al host en Moshpit.
  2. Abre Ajustes › Configurar este host y toca el host conectado.
  3. En ESTADO DEL AGENTE, elige un agente y toca Instalar (o Actualizar / Reinstalar). Toca la fila de prueba de abajo dentro de un panel abierto de tmux para comprobar que el script funciona.
  4. En NOTIFICACIONES PUSH, toca Emparejar (o Volver a emparejar), y luego toca Enviar una notificación de prueba manteniendo Moshpit abierto en pantalla para confirmar la entrega completa.

Las notificaciones push requieren openssl y curl en el host. Instalar jq es opcional y permite que los avisos de turno terminado incluyan el prompt que respondió el agente.

Todos los archivos de Moshpit viven en ~/.moshpit, y solo los agentes detectados en ese host reciben entradas de hooks salvo que confirmes explícitamente instalar para otro agente:

Ruta Propósito
~/.moshpit/moshpit-stamp.sh Invocado por los hooks del agente; escribe opciones @moshpit_* en el panel de tmux y dispara avisos de «te necesita» y «listo».
~/.moshpit/moshpit-push.sh Cifra el estado en el host y envía el texto cifrado al servidor relay.
~/.moshpit/manifest.json Resúmenes SHA-256 de los archivos instalados para saber cuándo los scripts están desactualizados.
~/.moshpit/push.d/<connection-id>.conf Secreto de emparejamiento de 256 bits y token de envío de este teléfono, guardados con modo 0600.
<config>.moshpit.orig Copia de seguridad única creada antes de la primera edición de Moshpit sobre un archivo de configuración de agente.

Según qué agentes existan en el host, Moshpit añade entradas de hooks en ~/.claude/settings.json, ~/.codex/config.toml, ~/.gemini/settings.json, ~/.qwen/settings.json, ~/.qoder/settings.json, ~/.factory/settings.json (o ~/.factory/hooks.json) y ~/.codebuddy/settings.json. El resto de tu configuración en esos archivos se conserva intacta.

Codex no ejecuta hooks recién añadidos hasta que los apruebas en el propio host:

  1. Inicia codex en una shell de tu host.
  2. Ejecuta /hooks.
  3. Marca como confiables las cuatro entradas de Moshpit.

Hasta que completes este paso, Codex no informará su estado en tmux ni enviará notificaciones push.

Abre Ajustes › Configurar este host mientras estás conectado al host:

  • Solo un agente: elige el agente en ESTADO DEL AGENTE y toca Quitar.
  • Notificaciones push en este teléfono: toca Desemparejar en NOTIFICACIONES PUSH para borrar el archivo de emparejamiento de este teléfono y detener los envíos desde ese host.
  • Todo: toca Quitar Moshpit de este host y confirma. Moshpit elimina sus entradas de hooks de cada archivo de configuración de agente (sin tocar el resto), borra el emparejamiento de este teléfono y elimina ~/.moshpit si no queda ningún otro teléfono emparejado con ese host.