Codex TTS

Codex TTS is a small Windows text-to-speech monitor for Codex Desktop.

It watches Codex session logs, speaks new assistant messages with Windows voices, and provides a native PowerShell/WPF GUI for muting individual chats or assigning different voices per chat.

Features

• Speaks assistant messages, including intermediate progress updates.
• Does not speak user prompts.
• Skips fenced code blocks before speech.
• Routes speech by Codex session ID.
• GUI shows chat title, workspace, session ID, voice, and enabled state.
• Per-chat mute and per-chat voice selection.
• Start, stop, restart monitor, stop speech, and test voice buttons.

Requirements

• Windows
• Codex Desktop session logs under %USERPROFILE%\.codex\sessions
• Windows PowerShell 5
• Windows System.Speech voices

Install

Clone or download this repository, then run:

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

The installer copies the scripts to:

%USERPROFILE%\.codex\hooks

It also creates a desktop shortcut named Codex TTS.

Usage

Open the Codex TTS desktop shortcut.

Use the GUI to:

• Start Monitor
• Stop Monitor
• Restart Monitor
• Stop Speech
• Test Voice
• Enable or disable individual chats
• Change a chat's voice

Click Save after changing routes.

Configuration

The live config is created automatically on first run:

%USERPROFILE%\.codex\hooks\tts_routes.json

This repository includes tts_routes.example.json, not a live tts_routes.json, so personal Codex session IDs are not committed.

Tests

Run:

powershell -NoProfile -ExecutionPolicy Bypass -File .\run_tests.ps1

Notes

The monitor only speaks new assistant text appended after the monitor starts. It does not replay old messages from before startup.