voicedbyme Download

VoicedByMe / Use cases / Codex voice

OpenAI Codex · notify · hooks · MCP

Codex, out loud.

VoicedByMe gives OpenAI Codex a voice. One click sets Codex's notify program and a permission hook, so Codex reads its reply aloud when a turn is done and says what it wants permission to run, in a natural voice or your own, fully offline. It also adds a speak tool, so "say it in my voice" works.

Download for Windows Download for Mac Free for a day · then $30 once

Samples made offline with ready-made voices. All of them are AI-generated.

How it works

Connect once. Then look away.

  1. Install VoicedByMe

    Windows 10 and 11 or a Mac with Apple silicon. Pick a ready-made voice or clone your own from twenty seconds of talking.

  2. Connect Codex

    Open AI agents and press Connect next to Codex. It backs up your settings, then edits ~/.codex/config.toml and hooks.json. Codex asks you to trust the new hook once.

  3. Start a long task

    Codex tells you when the turn is done and when it needs your approval. You come back when it matters, not every thirty seconds to check.

What it says

The moments you'd otherwise miss.

When a turn is done

Codex's last message, read aloud and shortened the way you choose: what it changed, and whether the tests pass.

When it needs permission

"Codex wants to run cargo test. Allow it?" The actual command, not a ding, so you can decide from across the room.

When you ask it to speak

"Say the summary in my voice" works: Codex gets a speak tool over MCP and knows when to use it.

Its own voice

Give Codex one voice and Claude Code another, so you know which agent finished without looking.

Keeps your notify program

Codex runs only one notify program. If you already use one, for a desktop alert or Codex's Computer Use, VoicedByMe runs it first and then speaks.

Quiet when it should be

Quiet hours, and quiet while the terminal Codex runs in is in front of you. Nothing changes what Codex does.

Under the hood

Three small entries in your Codex settings.

Connect writes these for you, and Disconnect takes them out again. They're shown here so you know exactly what changes, or to set it up by hand.

Replies: the notify program

Codex runs its notify program after every turn and passes a JSON event as the last argument. The agent-turn-complete event carries last-assistant-message, and that's what gets read.

# ~/.codex/config.toml (at the very top)
notify = ["C:/Program Files/VoicedByMe/voicereader-say.exe", "--codex"]

Keep notify above every [table] header. In TOML, a key written below [mcp_servers] or [tui] belongs to that table, and Codex never sees it. That's the most common reason a notify program never runs.

Permission requests: a hook

// ~/.codex/hooks.json
{
  "hooks": {
    "PermissionRequest": [
      { "hooks": [{ "type": "command", "command": "…/voicereader-say --codex-hook", "timeout": 10 }] }
    ]
  }
}

Speaking on request: an MCP server

[mcp_servers.voice-reader]
command = "C:/Program Files/VoicedByMe/voicereader-say.exe"
args = ["--mcp"]

The real entries also carry the local port and a private key, so only programs on your computer can make it talk.

Compared

Other ways to hear from Codex.

ApproachWhen a turn is doneWhen it needs permissionVoiceText leaves your computerSetup
VoicedByMeReads the replySays the commandNatural AI voices or your ownNoOne click
Codex's own [tui] notificationsA desktop notification or bellA notificationNoneNoA few lines in config.toml
A notify script with the system voiceReads the replyNo: notify only fires when a turn endsThe system's voicesNoWrite and keep up a script
A notify script calling a cloud voice APIReads the replyNo: notify only fires when a turn endsNaturalYesA script and an API key

More on alerts that don't talk, for Codex and Claude Code: get a notification when Claude Code or Codex is done.

Be honest

When Codex's voice mode is what you want.

Codex has its own voice features for talking to it: dictation for your prompts, and a live voice conversation for Codex tasks in the ChatGPT desktop app on paid plans. If you want to steer Codex hands-free, back and forth, use those. They run through OpenAI.

VoicedByMe is the other direction, and it's always on: whatever Codex finishes or asks while you're doing something else, it tells you, on your computer, on any plan, in the voice you choose. The two work fine together.

Questions

Can Codex read its replies aloud?

Not by itself in the terminal. Codex can run a notify program after each turn, and VoicedByMe uses that to read the reply in a natural voice or yours. One click sets it up.

Does Codex have a voice mode?

Yes, for talking to it: dictation turns your speech into a prompt, and the ChatGPT desktop app has a live voice mode for Codex tasks on paid plans, run on OpenAI's servers. VoicedByMe adds spoken alerts and replies for everyday Codex work, offline, without starting a voice conversation.

How do I get a sound or notification when Codex is done?

Add [tui] with notifications = true to ~/.codex/config.toml for a desktop notification or bell, or set a notify program that plays a sound. To hear what Codex actually did, connect VoicedByMe. Details in our notifications guide.

Why isn't my Codex notify program running?

Usually one of three things: notify sits below a [table] header, so it belongs to that table; it's in a project's .codex/config.toml, where Codex ignores it; or a second program replaced the first, since Codex runs only one. Run the program by hand with a sample JSON argument to check it works.

Does it use tokens or my ChatGPT usage?

Hearing Codex doesn't: VoicedByMe reads text Codex has already written, and the voice runs on your computer. The speak tool's short description sits in Codex's context like any MCP tool's.

Is my code sent anywhere?

No. The voice runs on your computer and only takes requests from programs on it. Nothing Codex says out loud is uploaded.

Does it work with Claude Code too?

Yes. Claude Code, Codex, Cursor, Hermes Agent and the Claude app each connect with one click, and each can have its own voice. See Claude Code voice.

How much does it cost?

$30 once for the first 50 customers, then $50. No subscription. The full app is free for one day so you can try it first. A license is for one computer.

For Windows 10 and 11, and Macs with Apple silicon

Codex, in your ears.

$30once. Launch price for the first 50 customers, then $50.
One computer. No subscription.

Download for Windows Download for Mac Also for Windows 10 and 11 Also for Macs with Apple silicon

The full app, free for 24 hours. Purchases aren't refundable, so please try it first.