Codex Hooks Tutorial for Beginners: Automate Your Workflow with Audio Notifications

## A. 相关脚本 > 1.1 .codex/config.toml ``` [features] codex_hooks = true ``` > 1.2 .codex/hooks.json ``` { "hooks": { "UserPromptSubmit": [ { "hooks": [ { "type": "command", "command": "\".codex/scripts/play-codex-audio.macos.sh\" \"start\" \".codex/audio/task-start.mp3\"", "timeout": 5 } ] } ], "PermissionRequest": [ { "matcher": "*", "hooks": [ { "type": "command", "command": "\".codex/scripts/play-codex-audio.macos.sh\" \"permission\" \".codex/audio/permission-needed.mp3\"", "timeout": 5 } ] } ], "Stop": [ { "hooks": [ { "type": "command", "command": "\".codex/scripts/play-codex-audio.macos.sh\" \"stop\" \".codex/audio/task-complete.mp3\"", "timeout": 5 } ] } ] } } ``` > 2.1 .codex/scripts/play-codex-audio.macos.sh ``` #!/usr/bin/env bash set -u event_name="${1:-}" audio_file="${2:-}" case "$event_name" in stop) hook_input="$(cat)" has_final_message="$( printf '%s' "$hook_input" | python3 -c 'import json,sys; data=json.load(sys.stdin); print("yes" if data.get("last_assistant_message") else "no")' 2>/dev/null )" if [ "$has_final_message" != "yes" ]; then exit 0 fi ;; esac if [ -z "$audio_file" ] || [ ! -f "$audio_file" ]; then exit 0 fi if command -v afplay >/dev/null 2>&1; then nohup afplay "$audio_file" >/dev/null 2>&1 & fi exit 0 ``` > 2.2 .codex/scripts/play-codex-audio.windows.ps1 ``` param( [string]$EventName, [string]$AudioFile ) if ($EventName -eq "stop") { $hookInput = [Console]::In.ReadToEnd() $hasFinalMessage = $false if (-not [string]::IsNullOrWhiteSpace($hookInput)) { try { $data = $hookInput | ConvertFrom-Json $hasFinalMessage = -not [string]::IsNullOrWhiteSpace([string]$data.last_assistant_message) } catch { $hasFinalMessage = $false } } if (-not $hasFinalMessage) { exit 0 } } if ([string]::IsNullOrWhiteSpace($AudioFile) -or -not (Test-Path -LiteralPath $AudioFile)) { exit 0 } try { Add-Type -AssemblyName PresentationCore $player = New-Object System.Windows.Media.MediaPlayer $player.Open([Uri]::new((Resolve-Path -LiteralPath $AudioFile).Path)) $player.Play() Start-Sleep -Milliseconds 1200 } catch { } exit 0 ``` > 2.3 .codex/scripts/play-codex-audio.linux.sh ``` #!/usr/bin/env bash set -u event_name="${1:-}" audio_file="${2:-}" case "$event_name" in stop) hook_input="$(cat)" has_final_message="$( printf '%s' "$hook_input" | python3 -c 'import json,sys; data=json.load(sys.stdin); print("yes" if data.get("last_assistant_message") else "no")' 2>/dev/null )" if [ "$has_final_message" != "yes" ]; then exit 0 fi ;; esac if [ -z "$audio_file" ] || [ ! -f "$audio_file" ]; then exit 0 fi if command -v paplay >/dev/null 2>&1; then nohup paplay "$audio_file" >/dev/null 2>&1 & elif command -v mpg123 >/dev/null 2>&1; then nohup mpg123 -q "$audio_file" >/dev/null 2>&1 & elif command -v ffplay >/dev/null 2>&1; then nohup ffplay -nodisp -autoexit "$audio_file" >/dev/null 2>&1 & fi exit 0 ``` ## B. 音频文件 > 3.1 通知音频文件下载 ``` https://pan.quark.cn/s/07c47e87f6e7 ``` ## C. links > 4.1 Codex Hooks 官方文档 ``` https://developers.openai.com/codex/hooks ```