Idevarts Codex Notifier
Idevarts Codex Notifier is an unofficial VS Code extension that watches local OpenAI Codex log output and notifies you when a Codex turn finishes.
It is built for developers who keep Codex running in VS Code while they review another file, switch windows, or step away for a moment.
Features
- Detects Codex turn start and completion markers from the local VS Code extension logs.
- Starts automatically when VS Code finishes startup.
- Plays the default Windows notification sound or a custom WAV/MP3 file.
- Shows native Windows notifications through Notification Center.
- Can optionally show VS Code popup notifications.
- Lets you skip short Codex turns with a configurable minimum duration.
- Can notify only when the current VS Code window is unfocused.
- Includes diagnostics and test commands for the detector, watcher, sound, and Windows notifications.
Requirements
- VS Code
1.125.0 or newer.
- The OpenAI Codex experience provided by the
openai.chatgpt VS Code extension.
- Windows is recommended for the full notification experience.
The extension can run on other platforms, but native Windows notifications are only available on Windows. Sound playback currently uses PowerShell and the Windows media player APIs, so custom sound playback is also Windows-focused.
Install
After the extension is published, install it from the VS Code Marketplace:
ext install iDevArts.idevarts-codex-notifier
You can also install a packaged VSIX manually:
code --install-extension idevarts-codex-notifier-0.0.4.vsix
Usage
- Install and enable the OpenAI Codex extension in VS Code.
- Install Idevarts Codex Notifier.
- Run a Codex turn.
- When the turn completes, the notifier plays the configured sound and, on Windows, shows a native notification.
Use Idevarts Codex Notifier: Show Diagnostics from the Command Palette if notifications do not appear. The diagnostics output shows the selected Codex log, watcher state, notification settings, platform, and last known notification errors.
Commands
| Command |
Description |
Idevarts Codex Notifier: Test Alert |
Sends a test completion alert without waiting for Codex. |
Idevarts Codex Notifier: Show Diagnostics |
Opens diagnostic output for troubleshooting. |
Idevarts Codex Notifier: Test Completion Detector |
Runs sample log lines through the detector. |
Idevarts Codex Notifier: Start Codex Log Watcher |
Starts watching Codex logs. |
Idevarts Codex Notifier: Stop Codex Log Watcher |
Stops watching Codex logs. |
Idevarts Codex Notifier: Select Notification Sound |
Selects a custom WAV or MP3 file. |
Idevarts Codex Notifier: Reset Notification Sound |
Clears the custom sound and returns to the default Windows sound. |
Idevarts Codex Notifier: Test Windows Notification |
Sends a native Windows notification test. |
Settings
| Setting |
Default |
Description |
idevartsCodexNotifier.enabled |
true |
Enables automatic Codex completion notifications. |
idevartsCodexNotifier.showPopup |
false |
Shows a VS Code popup when Codex completes a turn. |
idevartsCodexNotifier.playSound |
true |
Plays a sound when Codex completes a turn. |
idevartsCodexNotifier.soundPath |
"" |
Absolute path to a custom WAV or MP3 notification sound. Empty uses the default Windows notification sound. |
idevartsCodexNotifier.minimumDurationSeconds |
3 |
Skips notifications for Codex turns shorter than this duration. |
idevartsCodexNotifier.notifyOnlyWhenUnfocused |
false |
Notifies only when the current VS Code window is unfocused. |
idevartsCodexNotifier.windowsNotification |
true |
Enables native Windows notifications. |
idevartsCodexNotifier.windowsNotificationMode |
always |
Controls native Windows notifications: always, unfocused, or never. |
Troubleshooting
- Run
Idevarts Codex Notifier: Test Alert to confirm basic alert behavior.
- Run
Idevarts Codex Notifier: Test Windows Notification to confirm native Windows notification support.
- Run
Idevarts Codex Notifier: Show Diagnostics and check whether a Codex log was found.
- Make sure notifications are enabled in Windows Settings.
- If you use a custom sound, make sure the file still exists and is a
.wav or .mp3 file.
Privacy
Idevarts Codex Notifier reads local VS Code log files to detect Codex turn completion. It does not send log contents, settings, sound paths, or notification data to any external service.
Development
npm install
npm run compile
npm test
npm run package
To create a VSIX for local testing or Marketplace upload:
npx @vscode/vsce package
Support
Report bugs and feature requests on GitHub:
https://github.com/febriarief/idevarts-codex-notifier/issues
Disclaimer
Idevarts Codex Notifier is unofficial and is not affiliated with, endorsed by, or sponsored by OpenAI.
