README.ja.md

# Voice Notify for Codex

[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [Русский](README.ru.md)

Codex が注意を求めたときや作業を終えたとき、非公開のローカル音声で知らせます。
権限要求、サブエージェントの変化、コンテキスト圧縮、タスク完了を見逃しやすい
macOS と Windows の利用者向けです。

### 使い方

- [ChatGPT で Voice Notify for Codex を開く](https://chatgpt.com/plugins/plugins_6a6600dd92148191a6dfe0c16eb85c83)か、下記の GitHub インストールコマンドを使います。
- ガイド付き設定を完了し、`/hooks` を自分で確認してから、音声、言語、
  ライフサイクルイベント、再生間隔を選びます。ローカル通知はテスト、
  ミュート、ミュート解除できます。

### 試してみる

- `Codex が権限を求めるか終了したら、女性の日本語音声で知らせて。`
- `ローカルの Stop 通知をテストしてから Voice Notify をミュートして。`
- `Tell me aloud when Codex finishes, using the female Japanese voice.`

### 重要な境界

- 実行時の再生はオフラインで、会話内容を保存も送信もしません。
- 対象は Codex ライフサイクル音声の設定だけです。一般的な TTS・ナレーション、
  音声文字起こし、クラウド通知、任意の OS 音声自動化、スクリーンショットからの
  アクション抽出には使用しません。
- サイレントインストールやフック信頼の回避は行いません。利用者が同梱フックを
  自分で確認して信頼し、無関係な通知設定は変更しません。

Verified on 2026-08-29: OpenAI Platform shows **Published**; the latest remote catalog snapshot shows **GLOBAL/AVAILABLE** with discoverability **UNLISTED**. `UNLISTED` は公開ディレクトリに掲載済みまたは検索可能という意味ではありません。リポジトリの 0.1.7 は更新候補であり、この確認済み状態は既存のリモート項目を説明するだけで、0.1.7 が審査または公開済みとは主張しません。

これは、MIT ライセンスのソースコードと別途ライセンスされた音声アセットを
使用する独立したプラグインです。OpenAI との提携や OpenAI による承認を
示すものではありません。

## 機能

次のイベントごとにローカル WAV を再生します。

- `SessionStart`
- `UserPromptSubmit`
- `PreToolUse`
- `PostToolUse`
- `PermissionRequest`
- `PreCompact`
- `PostCompact`
- `SubagentStart`
- `SubagentStop`
- `Stop`

バージョン 0.1.7 には、2 種類の音声プロファイル、5 言語、10 種類の
ライフサイクルイベントの全組み合わせに対応する 100 WAV ファイルが含まれます。
このパッチでは discovery メタデータと 5 言語 README の同等なファーストビュー
案内を明確にしました。音声アセットと実行時の動作は 0.1.6 から変更していません。

macOS に標準搭載されている `/bin/sh`、`plutil`、`afplay`、`osascript`、
または Windows PowerShell と `System.Media.SoundPlayer` を使用します。
Python や Xcode Command Line Tools は不要です。ネットワークコードや
テレメトリはなく、プロンプト、メッセージ、ツール入力、ツール出力を保存しません。
再生はノンブロッキングで、ローカルロックと短いクールダウンによって音声の重複を
防ぎます。

### インタラクティブなコードオントロジー

このリポジトリの自己完結型インタラクティブオントロジーは、
[Code Ontology Companion](https://github.com/battle-doll/code-ontology-companion) を使用して
Voice Notify `0.1.6` から生成したものです。

[インタラクティブグラフを開く](https://rawcdn.githack.com/battle-doll/codex-voice-notify/ce42d10e88fc490271bea2c123a611bfa3d12b13/codex-voice-notify-code-ontology.html)。
GitHub 上の [HTML ソースを表示・ダウンロード](https://github.com/battle-doll/codex-voice-notify/blob/code-ontology-showcase/codex-voice-notify-code-ontology.html)することもできます。

このスナップショットは 6 個の Python ファイルから 417 ノードと 769 関係を抽出しており、
パース警告は 0 件です。すべての関係に抽出根拠とソース範囲が付与されています。
シンボルを検索し、呼び出し元や依存関係を調べ、2D 構造ビューと 3D コンステレーションビューを
切り替えられます。また、各関係の抽出ルール、定性的な根拠、ランタイム状態、ソース範囲、制限事項を
詳細に確認できます。

ここで示すのは静的解析の証拠であり、実際のランタイム動作の証明ではありません。
Windows と macOS で実際に使用される PowerShell `.ps1` および POSIX shell `.sh` のフックエントリポイントは、
この Python スナップショットの解析範囲には含まれません。この例は明示的な公開許可を得て公開されています。
raw.githack は、GitHub 上のファイルを HTML の Content-Type でブラウザーに配信するための橋渡しにのみ使用しています。
自己完結型グラフ自体には、実行時の CDN やネットワーク依存関係はありません。

## GitHub からインストール

Codex にリポジトリ URL を渡してインストールを依頼するか、次を実行します。

macOS:

```bash
codex plugin marketplace add battle-doll/codex-voice-notify --ref main
codex plugin add codex-voice-notify@codex-voice-notify
```

Windows PowerShell:

```powershell
codex.cmd plugin marketplace add battle-doll/codex-voice-notify --ref main
codex.cmd plugin add codex-voice-notify@codex-voice-notify
```

## 初回セットアップ

インストール後、プラグインの **Finish first-time setup** プロンプトを選択するか、
Codex に自然な言葉で依頼します。

> 韓国語の女性音声で Voice Notify の初回セットアップを完了して。
> 必要であれば Codex CLI を確認して更新して。

この開始プロンプトは安全に繰り返し実行できます。現在の Codex プラグイン UI は、
初回使用後にプロンプトを条件付きで非表示にしないため、復旧や再セットアップにも
引き続き利用できます。

ガイド付きセットアップでは、次を行います。

1. `/hooks` に対応する Codex CLI バージョンを確認し、セットアッププロンプトで
   明示的に許可された場合に限り、必要に応じて npm または Homebrew の
   インストールを更新します。
2. 選択した音声と言語を保存します。
3. ローカルの `Stop` 通知をテスト再生します。
4. 新しいターミナルウィンドウを開き、確認済みの Codex CLI をその中で起動します。
   単に `/hooks` の入力案内を表示するだけではありません。

同梱のセットアップスクリプト自体は互換性を報告するだけで、ホストの
インストールを変更しません。Codex は CLI が npm、Homebrew cask、または
その他の場所からインストールされたかを確認し、許可された更新だけを行います。

新しく開いた Codex CLI ターミナルで `/hooks` と入力し、同梱コマンドを確認して、
明示的に信頼してください。その後、実際のライフサイクルイベントをテストする前に
Codex を完全に終了して再起動します。フックの信頼設定は保存されますが、すでに
実行中の Codex プロセスでは、次回起動まで新たに信頼したプラグインフックが
有効にならない場合があります。Codex はインストール時にサードパーティ製フックを
自動的に信頼せず、このプラグインもその確認を回避しません。

実行中の CLI 実行ファイルを置き換えられず更新に失敗した場合は、その CLI を終了し、
表示された更新コマンドを別のターミナルで実行してからセットアップをやり直してください。

## 設定

いつでも自然な言葉で依頼できます。例:

- 「英語の女性音声を使って。」
- 「Voice Notify を日本語の男性音声に変更して。」
- 「ロシア語の女性音声を使って。」
- 「Voice Notify を簡体字中国語の男性音声に変更して。」
- 「韓国語の女性音声に変更して。」
- 「Voice Notify をミュートして。」
- 「Stop 通知をテストして。」

Codex は `female` または `male` と、韓国語／ハングル (`ko`)、日本語 (`ja`)、
英語 (`en`)、ロシア語 (`ru`)、簡体字中国語 (`zh-CN`) を同梱の設定コマンドに
対応付けます。同梱の中国語バリエーションは `zh-CN` だけなので、種類を指定しない
「中国語」または「中文」という依頼は `zh-CN`（簡体字中国語、中国本土の標準中国語）
になります。クローンしたリポジトリから手動で実行することもできます。

macOS:

```bash
/bin/sh scripts/voice_notify_config.sh setup --voice female --language ko --open-hooks
/bin/sh scripts/voice_notify_config.sh show
/bin/sh scripts/voice_notify_config.sh set --voice female --language ko
/bin/sh scripts/voice_notify_config.sh set --voice male --language en
/bin/sh scripts/voice_notify_config.sh set --voice female --language ru
/bin/sh scripts/voice_notify_config.sh set --voice male --language zh-CN
/bin/sh scripts/voice_notify_config.sh test --event Stop
/bin/sh scripts/voice_notify_config.sh mute
```

Windows:

```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\voice_notify_config.ps1 setup -Voice female -Language ko -OpenHooks
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\voice_notify_config.ps1 show
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\voice_notify_config.ps1 set -Voice female -Language ko
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\voice_notify_config.ps1 set -Voice male -Language ru
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\voice_notify_config.ps1 set -Voice female -Language zh-CN
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\voice_notify_config.ps1 test -Event Stop
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\voice_notify_config.ps1 mute
```

既定値は `female`、`ko`、最小再生間隔 450 ms、8 イベント有効です。
ツールごとの通知が多くなりすぎないよう、`PreToolUse` と `PostToolUse` は利用可能な
まま既定で無効になっています。`PermissionRequest` は、Codex が実際に権限を
求めたときだけ再生されます。

## トラブルシューティング

- `/hooks` が認識されない場合は、Codex CLI を `0.145.0` 以降に更新し、
  セットアップをやり直してください。
- PowerShell が `codex.ps1` または `npm.ps1` をブロックする場合は、
  `codex.cmd` または `npm.cmd` を使用してください。同梱の Windows 設定コマンドの
  `-ExecutionPolicy Bypass` はそのプロセスだけに適用され、システムの実行ポリシーを
  変更しません。
- テスト音声は再生されるのにライフサイクル通知が出ない場合は、`/hooks` でフックを
  確認して信頼し、Codex を完全に再起動してください。

## 互換性

バージョン 0.1.7 は、システム提供の音声・スクリプト機能を使用する macOS と
Windows に対応します。macOS では Python や Xcode Command Line Tools は不要です。
ガイド付きフック設定には Codex CLI `0.145.0` 以降が必要です。Linux はまだ
対応していません。

## ライセンス

ソースコードは MIT ライセンスです。`assets/audio/` 以下のすべての WAV
ファイルは MIT ライセンスの対象外です。
[ASSET_LICENSE.md](ASSET_LICENSE.md) の限定的許諾により、これらは未改変の
まま、未改変かつ無償の Voice Notify for Codex のコピーに含める場合に限り、
個人的・非商用の通知再生目的でのみ使用、複製、再配布できます。

[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) は生成来歴のみを記録します。
男性通知セットの大部分は Fish Audio で作成され、韓国語のサブエージェント用
ファイル 2 個は現在の文言に合わせて Qwen Base で再生成されました。これらの
来歴情報によって音声アセットの利用条件が変わることはありません。