Notificaciones de Claude Code y Codex: alertas de escritorio y barra de menús
El único trabajo de Andon es captar tu atención en el momento justo —cuando un agente te necesita o se queda bloqueado— y, por lo demás, mantenerse en silencio. El tablero es el canal universal (funciona en cualquier dispositivo); estos añaden más, cada uno degradándose con elegancia en macOS / Linux / Windows.
Alertas de escritorio nativas
Sección titulada «Alertas de escritorio nativas»Un banner en la máquina que ejecuta el servidor, activado por defecto. Con sonido para los estados que te necesitan, en silencio para la finalización:
- te necesita (ámbar) / atascado (rojo) → banner + sonido (inmediato).
- terminado (verde) → un solo banner discreto (sin sonido), con un antirrebote de 4 s para que un verde transitorio nunca dispare un falso «listo».
andon serve # alerts on by defaultandon serve --say # also speak needs-you / stuck aloudandon serve --no-notify # turn alerts offUsa osascript/say (macOS), notify-send/spd-say (Linux), toast de PowerShell/System.Speech
(Windows). Si falta la herramienta → se omite en silencio. (Se desactiva automáticamente con
--demo para que los agentes falsos que van rotando no te saturen.) Las alertas están
limitadas (un enfriamiento por sesión + un cubo de tokens global) para que un cliente de la LAN
ocupado —o malicioso— que publique en /event no pueda desencadenar una avalancha de creación de procesos.
Barra de menús / de estado
Sección titulada «Barra de menús / de estado»Un resumen de un vistazo, sin necesidad de una pantalla aparte:
curl -s http://127.0.0.1:8787/menubar # plain-text summary endpointConéctalo a SwiftBar/xbar (macOS) o Waybar/polybar (Linux); consulta
examples/andon-menubar.5s.sh.
¿Menos interrupciones? Configura tú mismo las aprobaciones
Sección titulada «¿Menos interrupciones? Configura tú mismo las aprobaciones»Andon nunca toca tus ajustes de permisos/aprobaciones: eso es cosa tuya. Si el ámbar «te necesita» salta más de lo que querrías, preaprueba las operaciones seguras en la propia configuración de tu agente (así Andon solo se encenderá para el resto):
- Claude Code — añade patrones de solo lectura a
permissions.allowen~/.claude/settings.json, p. ej."Read","Bash(git status:*)","Bash(npm test:*)". Tus reglasdeny/asksiempre tienen prioridad, y el comparador de Bash entiende los operadores de shell (así queBash(git status:*)no aprobarágit status && rm -rf). Consulta/permissions. - Codex — define
approval_policy(p. ej."untrusted"ejecuta automáticamente los comandos de solo lectura de confianza) y/osandbox_modeen~/.codex/config.toml.
Mantener esto en tus manos significa que Andon nunca puede debilitar tus reglas de seguridad, y el tablero sigue siendo un fiel reflejo de cuándo se te necesita de verdad.