Guide

Wissen, wann eine Codex-Aufgabe auf Sie wartet

Updated

Also in: English, Français, Español, Português

On this page

Die Codex CLI kann Sie benachrichtigen, wenn ein Turn endet und wenn sie anhält, um eine Genehmigung einzuholen. Aktivieren Sie beides unter [tui] in ~/.codex/config.toml. Um bei Abschluss eines Turns ein eigenes Skript auszuführen, fügen Sie notify hinzu. Und wenn Sie mehrere Sitzungen ausführen, erspart Ihnen ein Display, das anzeigt, welche Sitzung wartet, die Suche in Fenstern.

Logitech MX Creative Keypad mit Orbtile, mit einer wartenden Codex-Sitzung ganz vorne

1. Terminal-Benachrichtigungen

Fügen Sie dies zu ~/.codex/config.toml hinzu:

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

notifications = true aktiviert alle; eine Liste übernimmt nur die von Ihnen benannten Ereignisse. Zwei weitere Einstellungen gehören in dieselbe Tabelle:

  • notification_condition: "unfocused" (Standard) benachrichtigt nur, wenn das Terminal nicht im Vordergrund ist; "always" benachrichtigt jedes Mal.
  • notification_method: "auto" (Standard) sendet eine Desktop-Benachrichtigung, wo das Terminal dies unterstützt, andernfalls ein Terminal-Glockensignal; "osc9" oder "bel" erzwingen eine der beiden Optionen.

2. Ein eigenes Programm bei Abschluss eines Turns ausführen

notify führt nach jedem Turn ein Programm aus und übergibt ihm ein JSON-Argument. Platzieren Sie es nahe dem Dateianfang, vor jeder [table]-Zeile:

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

Das JSON enthält type (agent-turn-complete), thread-id, turn-id, cwd, input-messages und last-assistant-message. Auf dem Mac zeigt dieses Skript die letzte Antwort als Benachrichtigung an:

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 wird nur bei Turn-Abschluss ausgelöst. Für Genehmigungsanfragen nutzen Sie die obige Benachrichtigung approval-requested.

Wie die CLI installiert wird, config.toml und AGENTS.md lädt und nicht-interaktiv mit codex exec ausgeführt wird, siehe OpenAI Codex CLI: install, commands, config.toml and codex exec.

Welche Option zu wählen ist

You wantUse
Wissen, wann ein Turn endet oder Codex eine Genehmigung braucht[tui] notifications
Eigener Ton, eigenes Banner oder eigene Nachrichtnotify mit einem Skript
Sehen, welche von mehreren Sitzungen wartetEin Display, das jede Sitzung anzeigt

Wenn Benachrichtigungen nicht mehr ausreichen

Eine Benachrichtigung sagt Ihnen, dass irgendeine Codex-Sitzung Sie braucht. Mit einem Desktop-Chat, zwei Terminal-Sitzungen und einem laufenden codex exec müssen Sie immer noch herausfinden, welche es ist.

Orbtile zeigt jede Codex-Sitzung als eigene Taste auf dem Logitech MX Creative Keypad oder als Kachel auf einem iPhone oder Android-Smartphone: Desktop-App-Chats, Terminal-Sitzungen und codex exec-Durchläufe. Es liest die eigenen Sitzungsdateien von Codex, sodass nichts installiert werden muss. Eine wartende Sitzung leuchtet magentaviolett und rückt nach vorne. Über die Tasten können Sie Befehlsfreigaben der Codex-Desktop-App und deren Single-Choice-Fragen beantworten. Für Befehlsfreigaben in Terminal-Sitzungen bieten die Tasten Allow; um abzulehnen, antworten Sie im Terminal. Alles andere zeigt Answer on computer.

Zu den Terminal- und Web-UI-Hinweisen von Kimi Code siehe Kimi Code notifications: hooks, NotifyUser and TUI settings.

FAQ

Why doesn't notify fire when Codex asks for approval?

Es wird nur ausgeführt, wenn ein Turn abgeschlossen ist. Fügen Sie stattdessen "approval-requested" zu [tui] notifications hinzu.

Can I get notified even when the terminal is in front?

Ja. Setzen Sie notification_condition = "always" unter [tui].

Does Orbtile change my Codex config?

Nicht ohne Ihre Zustimmung. Optionale Codex-Hooks fügen einen Komprimierungsstatus und etwas frühere Aktualisierungen hinzu; wenn Sie diese in den Einstellungen von Orbtile installieren, prüfen und autorisieren Sie sie zuerst in Codex.

Does it work on Windows?

Ja. Orbtile läuft auf Windows 11 und unterstützt Codex dort ab Orbtile 0.3.0, zusammen mit Claude Code, ZCode und Antigravity sowie Kimi Code ab 0.3.6.