Volver al blog

Notificaciones push para Cline y Aider: sabe cuándo te toca

Notificaciones push para Cline y Aider: sabe cuándo te toca

Cline y Aider son los dos agentes de programación de código abierto que más gente deja ejecutándose en segundo plano, y ambos pueden ejecutar un comando cuando hay algo que revisar. Ninguno envía nada a tu teléfono por sí solo. Unas pocas líneas de configuración lo cambian.

  • Cline ejecuta un script de hook cuando termina una tarea y habla MCP, así que también puede enviar notificaciones push que él mismo escribe.
  • Aider ejecuta un comando de notificación cuando espera tu respuesta, después de una respuesta o antes de una confirmación de sí o no.

Ambos envían a través de Pocket Alert, así que las notificaciones llegan a la misma app, con el mismo historial, que las alertas de todo lo demás que ejecutas.

Lo que necesitas

  • Una cuenta de Pocket Alert, una clave de API de Claves de API y la app en tu iPhone o Android. El plan gratuito es suficiente.
  • curl, y jq para el hook de Cline.

Guarda la clave en un archivo. Los editores que se abren desde el Dock en macOS no leen tu perfil de shell, así que un archivo es el único lugar donde ambos agentes siempre la encuentran:

mkdir -p ~/.config/pocketalert
printf '%s' 'YOUR_API_KEY' > ~/.config/pocketalert/key
chmod 600 ~/.config/pocketalert/key

Cline

Un hook para las tareas terminadas

Los hooks de Cline son archivos ejecutables con el nombre del evento. Coloca un script llamado TaskComplete, sin extensión, en ~/Documents/Cline/Hooks/ y Cline lo ejecutará cada vez que termine una tarea en cualquier espacio de trabajo. Para un solo proyecto, usa .clinerules/hooks/TaskComplete dentro del repositorio.

El script recibe un objeto JSON por stdin. Para TaskComplete, los campos importantes son taskComplete.taskMetadata.result, la respuesta final de Cline, y workspaceRoots, las carpetas abiertas. También existe un campo initialTask, pero la extensión actual lo envía vacío:

#!/usr/bin/env bash
payload=$(cat)
project=$(basename "$(jq -r '.workspaceRoots[0] // "Cline"' <<<"$payload")")
result=$(jq -r '.taskComplete.taskMetadata.result // "" | if . == "" then "Done" else . end' <<<"$payload")

jq -n --arg t "Cline finished · $project" --arg m "${result:0:300}" \
  '{title: $t, message: $m}' |
  curl -sS --max-time 5 https://api.pocketalert.app/v1/messages \
    -H "Token: $(cat ~/.config/pocketalert/key)" \
    -H 'Content-Type: application/json' \
    --data-binary @- >/dev/null 2>&1 || true

echo '{"cancel":false,"contextModification":"","errorMessage":""}'
mkdir -p ~/Documents/Cline/Hooks
# save the script above as ~/Documents/Cline/Hooks/TaskComplete, then:
chmod +x ~/Documents/Cline/Hooks/TaskComplete

La última línea es la respuesta del hook para Cline: no cancelar, no añadir nada al contexto, sin error. Los hooks tienen un límite de 30 segundos, por eso curl se detiene a los cinco.

Asegúrate de que los hooks estén activados: el interruptor Hooks en la configuración de funciones de Cline está activado por defecto. Los hooks se ejecutan en macOS y Linux como scripts de shell; en Windows, Cline espera un script de PowerShell llamado TaskComplete.ps1.

¿Y si "Cline está esperando aprobación"?

La lista de hooks de Cline incluye un evento Notification precisamente para eso, pero en la extensión 4.x actual está definido y todavía no se llama. Mientras no se llame, no hay un hook fiable para las solicitudes de aprobación: PreToolUse se activa antes de cada herramienta, incluidas las que se aprueban automáticamente. Si quieres alejarte, la ruta práctica es ampliar la aprobación automática de Cline para acciones seguras y dejar que TaskComplete te avise cuando el trabajo termine.

El servidor MCP

Cline es un cliente MCP, así que también puede enviar notificaciones push a través del servidor MCP de Pocket Alert. Añádelo al archivo de configuración MCP de Cline, ~/.cline/data/settings/cline_mcp_settings.json:

{
  "mcpServers": {
    "pocketalert": {
      "type": "streamableHttp",
      "url": "https://mcp.pocketalert.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" },
      "disabled": false,
      "autoApprove": ["create_message"]
    }
  }
}

Indica type de forma explícita: sin él, Cline asume el transporte SSE más antiguo y la conexión falla. autoApprove permite que Cline envíe una notificación push sin preguntarte antes, que es justo lo que quieres cuando no estás delante del equipo. Las versiones recientes de Cline leen el mismo archivo desde la extensión de VS Code, la CLI y JetBrains.

Después, añade una instrucción en .clinerules:

When you finish a task that took more than a few minutes, call the pocketalert
create_message tool with a one-line summary. Use level "high" if something failed.

Aider

Aider tiene notificaciones integradas. Con --notifications muestra una notificación de escritorio (o hace sonar la campana del terminal) cuando espera tu entrada, y --notifications-command la reemplaza por el comando que quieras. Eso es todo lo que necesita una notificación push al teléfono.

El comando

Aider ejecuta el comando a través del shell sin argumentos, así que el script construye el mensaje con lo que puede ver: el directorio actual es el repositorio en el que trabaja Aider.

#!/usr/bin/env bash
project=$(basename "$PWD")

curl -sS --max-time 5 https://api.pocketalert.app/v1/messages \
  -H "Token: $(cat ~/.config/pocketalert/key)" \
  -H 'Content-Type: application/json' \
  -d "{\"title\": \"Aider is waiting · $project\", \"message\": \"Your turn: reply or confirm in the terminal.\"}" \
  >/dev/null 2>&1 || true

Guárdalo como ~/.config/pocketalert/aider-notify.sh y ejecuta chmod +x sobre él.

Si tienes instalada y autenticada la CLI de Pocket Alert 2.0 o posterior, puedes saltarte el script y poner el comando directamente en la configuración de abajo:

notifications-command: 'pocketalert send -t "Aider is waiting · $(basename "$PWD")" -m "Your turn, reply or confirm in the terminal" -q'

Las comillas simples evitan que YAML interprete el resto de la línea; Aider se lo pasa tal cual al shell.

Activarlo

Añade dos líneas a ~/.aider.conf.yml, o a .aider.conf.yml dentro de un repositorio:

notifications: true
notifications-command: ~/.config/pocketalert/aider-notify.sh

O para una sola ejecución:

aider --notifications --notifications-command ~/.config/pocketalert/aider-notify.sh

Cuándo se activa

Aider envía una notificación por cada respuesta del modelo, en el primer momento en que espera tu entrada después. Normalmente es el aviso habitual tras terminar de editar. Si lo primero que necesita es una confirmación, como "¿Añadir archivo al chat?" o "¿Ejecutar comando de shell?", la notificación llega por esa, que es el caso de "esperando aprobación". Las confirmaciones posteriores dentro del mismo intercambio no envían otra notificación.

Aider no tiene soporte para MCP, así que el comando de notificación es la vía a seguir. Además, es suficiente: Aider espera tu entrada después de cada respuesta, y ese es el momento en que quieres saberlo.

Lo que llega a tu teléfono

AgenteTítuloCuerpo
ClineCline ha terminado · apiLos primeros 300 caracteres del resultado de Cline
Cline mediante MCPLo que escriba el agenteUn resumen que el agente decide enviar
AiderAider is waiting · apiYour turn: reply or confirm in the terminal.

Los mensajes tienen prioridad normal por defecto. Añade "level": "high" al JSON si quieres que lleguen aunque tengas activado Concentración en el iPhone, o mantenlos silenciosos con "low" y revisa el historial cuando vuelvas.

Si no llega nada

  • Ejecuta el script a mano. Para Cline, echo '{}' | ~/Documents/Cline/Hooks/TaskComplete; para Aider, ~/.config/pocketalert/aider-notify.sh. Si no llega ninguna notificación, el problema está en la clave o en la red; quita >/dev/null 2>&1 para ver la respuesta de curl.
  • Revisa el nombre del archivo. Cline identifica los hooks por su nombre: TaskComplete exactamente, ejecutable, sin .sh.
  • Revisa la clave de configuración de Aider. Usa notifications-command con guion, como en el ejemplo de configuración de Aider.

Preguntas frecuentes

¿Necesito los dos agentes?

No. Las dos secciones son independientes; configura el que uses.

¿Cline o Aider pueden ver mi clave de API?

El hook y el comando de notificación leen la clave desde un archivo y no forman parte de la conversación. La configuración de MCP guarda la clave para que Cline pueda conectarse al servidor; no se envía al modelo.

¿Aider me llenará el teléfono de notificaciones mientras estoy escribiendo?

Envía una notificación push por respuesta. Si es demasiado mientras estás en el escritorio, inicia Aider sin --notifications y usa el archivo de configuración solo en sesiones largas, o añade una comprobación al principio del script, como [ -f ~/.aider-away ] || exit 0, y crea ese archivo cuando te vayas.

¿Es gratis?

Sí. Cline y Aider son de código abierto, y el plan gratuito de Pocket Alert cubre 50 mensajes al día en un dispositivo.

Obtén una clave de API, añade el script y deja que el agente te avise.

Comparte este artículo