Sepa cuándo una tarea de Codex está esperando su atención

La CLI de Codex puede notificarle cuando finaliza un turno y cuando se detiene para pedirle aprobación. Active ambas opciones bajo [tui] en ~/.codex/config.toml. Para ejecutar un script propio cuando termine un turno, añada notify. Y cuando ejecute varias sesiones, una pantalla que muestre cuál está esperando le ahorrará tener que buscar entre distintas ventanas.

1. Notificaciones en la terminal

Añada esto a ~/.codex/config.toml:

[tui]
notifications = ["agent-turn-complete", "approval-requested"]

notifications = true las activa todas; especificar una lista conserva solo los eventos nombrados. En la misma tabla se configuran dos opciones adicionales:

• notification_condition: "unfocused" (predeterminado) notifica solo mientras la terminal no esté en primer plano; "always" notifica en cada ocasión.
• notification_method: "auto" (predeterminado) envía una notificación de escritorio donde la terminal lo admita y una señal sonora en caso contrario; "osc9" o "bel" fuerzan una de las dos opciones.

2. Ejecutar su propio programa cuando finalice un turno

notify ejecuta un programa tras cada turno y le pasa un argumento JSON. Sitúelo cerca de la parte superior del archivo, por encima de cualquier línea [table]:

notify = ["python3", "/Users/you/.codex/notify.py"]

El objeto JSON incluye type (agent-turn-complete), thread-id, turn-id, cwd, input-messages y last-assistant-message. En Mac, este script muestra la última respuesta como una notificación:

import json, subprocess, sys

event = json.loads(sys.argv[1])
if event.get("type") == "agent-turn-complete":
    text = (event.get("last-assistant-message") or "Turn complete")[:120]
    subprocess.run(["osascript", "-e",
        f"display notification {json.dumps(text)} with title \"Codex\""])

notify solo se activa cuando se completa un turno. Para solicitudes de aprobación, utilice la notificación approval-requested descrita anteriormente.

Para conocer cómo se instala la CLI, cómo carga config.toml y AGENTS.md, y cómo se ejecuta de forma no interactiva con codex exec, consulte CLI de OpenAI Codex: instalación, comandos, config.toml y codex exec.

Cuál utilizar

Cuando las notificaciones no son suficientes

Una notificación le avisa de que alguna sesión de Codex le necesita. Con un chat de escritorio, dos sesiones de terminal y una ejecución de codex exec en marcha, todavía tiene que averiguar cuál de ellas es.

Orbtile muestra cada sesión de Codex en su propia tecla en el Logitech MX Creative Keypad o en una casilla en un iPhone o un teléfono Android: chats de la aplicación de escritorio, sesiones de terminal y ejecuciones de codex exec. Lee directamente los archivos de sesión de Codex, sin instalaciones adicionales. Una sesión en espera se ilumina en magenta-violeta y pasa al primer plano. Desde las teclas puede responder a las aprobaciones de comandos de la aplicación de escritorio de Codex y a sus preguntas de opción única. Para la aprobación de un comando de terminal, las teclas ofrecen Allow; para rechazarlo, responda en la terminal. Cualquier otra situación muestra Answer on computer.

Para las alertas de terminal y de la interfaz web de Kimi Code, consulte Kimi Code notifications: hooks, NotifyUser and TUI settings.