Codex Watch support

Set up

  1. Get the Mac companion from Codex Watch. Open it alongside Codex on your Mac.
  2. In Remote access, choose Start if it is stopped, then Pair watch.
  3. Open Codex Watch on Apple Watch. Allow Bluetooth, select your Mac and compare the numbers on both devices. Choose Approve on the Mac.
  4. Choose a chat on the Watch. Tap Message, allow microphone access and speak. Tap Finish, review the transcript and choose Send.

You need an Apple silicon Mac running macOS 26 or later, Apple Watch with watchOS 10 or later, and existing Codex access. Both devices need internet access. Keep the Mac awake with Codex and the companion running. No separate iPhone app, Cloudflare account or network configuration is required.

To explore without connecting a Mac, choose Try demo on the Watch pairing screen. It uses sample content and does not run a real task.

Connection and delivery

If your Mac is missing during pairing, check Bluetooth permissions and reopen Pair watch. If a chat is unavailable, open it in Codex on the Mac first.

The current relay uses a stable Mac identity and reconnects automatically after a network interruption or companion restart. Check the Mac’s internet connection and sleep state if it stays offline. Closing a MacBook lid can put it to sleep even while the companion is open. Reopening the Watch app refreshes its connection.

Existing pairings from an earlier version may still use their original direct address. Use Connection settings → Connect a Mac and pair again with the current companion to move to the encrypted relay.

The relay does not hold actions for execution while the Mac is offline. A failed outgoing message stays on your Watch for review and retry. For Delivery unconfirmed, check the conversation on your Mac before sending again. Work already delivered or queued inside Codex may continue independently.

Voice drafts

If transcription fails, the saved recording remains available for retry. Keep the Mac connected; first use of a language may download its recognition model. An interrupted recording upload can resume while its temporary Mac upload remains available. If that temporary copy expires or the companion restarts, retry sends the saved Watch recording again.

Closing a finished draft keeps it. Continue recording adds to it. Changing the dictation language starts a new segment without changing an earlier recording’s language. Delete all draft clears the active composer and offers Undo for 60 seconds, but retained archived/discarded files mean it is not a full-data erase control.

Complications and notifications

The first release does not send background push notifications. Messages refresh while the app is open. watchOS controls complication refresh timing; stale or unavailable information may show a last-seen state or a dash. Open the app to refresh.

Disconnect or remove data

Remove the Watch from the Mac companion to revoke future access. The relay receives that change while the Mac is connected, or when it next reconnects. Revocation does not delete existing recordings, conversation caches or Codex history.

To remove companion data, first quit Codex Watch. In Finder, choose Go → Go to Folder and open ~/Library/Application Support/Codex Watch/. Save recordings you want to keep, then remove the companion folder. Earlier installations or a migration fallback may still use ~/Library/Application Support/Codex Remote/; inspect that path too. It may be a link to the new folder. If both paths are separate folders, both may contain retained data. Removing companion data resets pairing and does not itself delete the relay’s retained routing record.

Removing the Watch app removes its application container. Keychain credentials or backups may remain separately; revoke access on the Mac as well. Manage Codex conversation history through Codex/OpenAI. See the privacy policy for retention details.

Contact

Email support@bluematters.studio with your app version, watchOS/macOS versions, what happened and the approximate time. Include relevant error text. Do not send pairing codes, authentication tokens, encryption keys, private conversation exports or raw recordings.