Skip to content

Codex

When you step away from your computer, Codex asks your phone for permission to run something or edit files, and for its multiple-choice questions. You also hear when it finishes a task.

  1. In the app, open Add a source, then For developers, and pick Codex.

  2. Copy the command Yoohoo shows and run it in a terminal on your computer. It looks like this:

    Terminal window
    npx yoohoo-cli connect codex --code <code> --server <url>
  3. Trust the hooks in Codex. Codex runs new hooks only after you trust them. Open Codex and type /hooks, or in the Codex app go to Settings, then Hooks, and trust Yoohoo’s four hooks.

  4. Wait for Yoohoo to say the computer is connected.

The code works once and lasts 10 minutes. If it runs out, tap Get a new code.

The command adds hooks to ~/.codex/hooks.json. It needs Node 20 or newer.

To connect another computer, open the source and tap Add another computer.

While you’re at the computer, Codex asks you there as usual. Once nobody has touched the keyboard or mouse for 30 seconds, Yoohoo asks your phone instead. When you come back, the question goes back to the computer.

Tap Allow or Deny right on the notification. Allowing needs your phone unlocked. Open the alert to see the full command or file first. Nothing is ever allowed on its own.

On Linux, permissions and questions stay at the keyboard. You still hear when tasks finish.

You hear when Codex finishes. A task that took 2 minutes or more interrupts you right away. Shorter ones wait for the roundup.

To get long tasks in the roundup too, turn off A coding agent finishes a long task on the Rules screen.

If the hook can’t reach Yoohoo, it prints nothing and Codex asks at the keyboard as usual.

To stop one computer, open Codex in Sources and remove it from Your computers. Codex goes back to asking at the keyboard. To take the hooks off the computer too, run:

Terminal window
npx yoohoo-cli disconnect codex

This removes the hooks and forgets the computer’s token.