OpenAI Codex

Get a push when a Codex CLI turn completes.

Before you start

• Shared trigv-notify.sh script
• TRIGV_API_KEY exported in your environment
• Codex CLI with hooks support

Step 1 — Enable hooks

Edit ~/.codex/config.toml and add:

[features]
hooks = true

Step 2 — Add a Stop hook

Append to the same file:

[[hooks.Stop]]
[[hooks.Stop.hooks]]
type = "command"
command = "bash -c 'TRIGV_LEVEL=success ~/.local/bin/trigv-notify.sh \"Codex: turn complete\" \"Open terminal to review\" >/dev/null 2>&1 || true'"
statusMessage = "Notifying Trigv"

Step 3 — Trust and test

1. In Codex CLI, run /hooks to review new hook definitions.
2. Approve/trust the hook when prompted.
3. Run a Codex task and wait for completion — check your phone.

Troubleshooting

• Test trigv-notify.sh manually first.
• Hooks must not print to stdout — the command above redirects output.
• See Codex hooks docs.