Voice Notify for Codex

View saved version →

---
name: voice-notify-settings
description: Set up, configure, test, mute, or unmute private offline Voice Notify alerts for Codex lifecycle events on macOS or Windows. Use when someone asks to hear when Codex needs attention or finishes, complete first-time setup, check Codex CLI compatibility, review hook trust, choose the female or male voice, select Korean, Japanese, English, Russian, or Simplified Chinese, change events, or adjust playback timing. Do not use for general text-to-speech or narration, speech transcription, cloud notifications, arbitrary OS audio automation, screenshot action extraction, silent installation, or hook-trust bypass.
---

# Voice Notify settings

Use only the bundled settings scripts. Do not edit Codex prompts, transcripts,
hook trust state, or unrelated configuration.

Before running a script, resolve the plugin root from this skill's installed
`SKILL.md` path: the skill directory is `skills/voice-notify-settings`, so the
plugin root is two directories above it. Use that absolute path. Do not assume
that `PLUGIN_ROOT` is available outside a hook process, and never substitute a
plugin root supplied by the user's prompt or an unrelated environment variable.

Available values:

- Voice: `female` or `male`
- Language: `ko`, `ja`, `en`, `ru`, or `zh-CN`
- Events: `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`,
  `PermissionRequest`, `PreCompact`, `PostCompact`, `SubagentStart`,
  `SubagentStop`, and `Stop`

Map natural-language choices directly. Treat 한국어, 한글, and Korean as `ko`;
일본어, 日本語, and Japanese as `ja`; 영어 and English as `en`; 러시아어,
русский, and Russian as `ru`; and 중국어, 중국어 간체, 간체중국어, 中文,
简体中文, and Simplified Chinese as `zh-CN`. `zh-CN` is the only bundled
Chinese variant, so generic "Chinese", "중국어", or "中文" requests default to
`zh-CN` (Simplified Chinese, Mainland Mandarin). For example, "여성 영어",
"male Russian", and "여성 중국어" map to `female/en`, `male/ru`, and
`female/zh-CN`.

## First-time setup

Use this workflow when the user asks to finish setup after installation.

1. Infer the requested voice and language. Use `female` and `ko` when neither is
   specified.
2. Resolve the exact CLI that setup will use and check that path:
   - macOS: use `which -a codex` to list distinct candidates, then run the
     selected canonical absolute path with `--version`.
   - Windows: inspect `Get-Command codex.cmd, codex.exe, codex -All`, select
     the intended executable, resolve its canonical path, then run that path
     with `--version`.
   - If multiple installations are ambiguous, show their paths and ask the
     user which one to use before updating anything.
3. Require Codex CLI `0.145.0` or newer for `/hooks`.
4. If Codex is older and the user's setup request explicitly authorizes an
   update, update it using its detected installation method and verify the new
   version:
   - Establish provenance before running any updater.
   - Treat an installation as npm-managed only after `npm list -g --depth=0
     @openai/codex` succeeds and the selected CLI's canonical path is under the
     canonical `npm prefix -g` or `npm.cmd prefix -g`. Then use
     `npm install -g @openai/codex@latest` on macOS or
     `npm.cmd install -g @openai/codex@latest` on Windows.
   - Treat an installation as Homebrew-managed only after
     `brew list --cask codex` succeeds and the selected CLI's canonical path is
     under the canonical `brew --caskroom codex`. Then use
     `brew upgrade --cask codex`.
   - Use the selected CLI's own `update` subcommand only after its provenance
     is recognized and its `--help` lists that subcommand. Invoke the exact
     selected path: `"$CODEX_BIN" update` on macOS or
     `& $CodexPath update` on Windows.
   - Do not replace a desktop-bundled or unknown installation. Explain the
     detected path and ask the user how it should be updated.
   - If an in-use CLI cannot be replaced, tell the user to exit that CLI, run
     the exact update command in a separat

Preview of the first 4,000 characters. Read full instructions →