Saiba quando uma tarefa do Codex está aguardando você

A CLI do Codex pode notificar quando um turno termina e quando ela faz uma pausa para pedir sua aprovação. Ative ambas as opções na seção [tui] do seu ~/.codex/config.toml. Para executar um script próprio quando um turno terminar, adicione notify. E quando você tiver várias sessões em execução, uma tela que mostre qual delas está aguardando evita que você perca tempo procurando entre janelas.

1. Notificações no terminal

Adicione isto ao seu arquivo ~/.codex/config.toml:

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

Definir notifications = true ativa todas elas; especificar uma lista mantém apenas os eventos nomeados. Duas outras configurações ficam na mesma tabela:

• notification_condition: "unfocused" (padrão) notifica apenas enquanto o terminal não estiver em primeiro plano; "always" notifica sempre.
• notification_method: "auto" (padrão) envia uma notificação na área de trabalho se o terminal for compatível e um aviso sonoro no terminal em outros casos; "osc9" ou "bel" forçam uma das duas opções.

2. Executar seu próprio programa quando um turno terminar

A opção notify executa um programa após cada turno e passa a ele um argumento em JSON. Insira-a perto do topo do arquivo, acima de qualquer linha [table]:

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

O JSON inclui type (agent-turn-complete), thread-id, turn-id, cwd, input-messages e last-assistant-message. No Mac, este script exibe a última resposta como uma notificação:

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\""])

O parâmetro notify dispara apenas quando um turno é concluído. Para pedidos de aprovação, utilize a notificação approval-requested explicada acima.

Para saber como a CLI é instalada, como ela carrega config.toml e AGENTS.md e como roda de forma não interativa com codex exec, consulte CLI do OpenAI Codex: instalação, comandos, config.toml e codex exec.

Qual usar

Quando as notificações não são suficientes

Uma notificação avisa que alguma sessão do Codex precisa de você. Com um chat no aplicativo para computador, duas sessões no terminal e uma execução com codex exec, você ainda precisa procurar qual delas é.

O Orbtile exibe cada sessão do Codex em sua própria tecla no Logitech MX Creative Keypad ou em um bloco em um iPhone ou celular Android: chats do aplicativo para computador, sessões de terminal e execuções do codex exec. Ele lê diretamente os arquivos de sessão do próprio Codex, sem necessidade de instalação adicional. Uma sessão que está aguardando acende em magenta-violeta e vai para a frente. Pelas teclas, você pode aprovar comandos do aplicativo para computador do Codex e responder a perguntas de escolha única. Para aprovação de comando em sessões de terminal, as teclas oferecem Allow; para recusar, responda no terminal. Qualquer outra solicitação mostra Answer on computer.

Para avisos de terminal e na interface web do Kimi Code, consulte Kimi Code notifications: hooks, NotifyUser and TUI settings.