Install the Mac companion
Download owodex Agent and open it on the Mac that already has your Codex setup.
iPhone companion for local Codex
owodex
Control Codex on your Mac from your iPhone. Install owodex Agent on the Mac, scan its QR code in the iPhone app, and keep your real project sessions moving.
- Your Mac runs Codex
- Your phone controls the session
- QR pairing connects the two
Pairing
Where the QR code comes from
The QR code is created by owodex Agent on your Mac. The iPhone app scans that code so it knows which machine should receive Codex prompts.
Open the QR page
owodex Agent opens a local browser page with a pairing QR and connection details.
Scan from Machines
Open the iPhone app, tap Machines, scan the Mac QR, then return to Chat.
Downloads
Install both parts
owodex needs the iPhone app for control and owodex Agent on macOS for the local bridge.
iPhone
owodex app
Use the iPhone app to scan the Mac QR, choose a machine, and chat with Codex.
App Store app
Get owodex on the App StoreInstall owodex, open Machines, then scan the QR from owodex Agent on your Mac.
macOS
owodex Agent
Run this on the Mac that should host Codex, expose the pairing QR, and receive prompts.
Download available
Download owodex AgentOpen the Mac companion, keep the QR page visible, then scan it from Machines in owodex.
What runs where
A simple boundary
On iPhone
- Scan the Mac QR
- Pick the paired machine
- Send prompts and resume chats
On Mac
- Run owodex Agent
- Host the Codex session
- Keep project context local
FAQ
Common setup questions
Why does the app ask me to pair?
The app needs a Mac running owodex Agent before it can send prompts into Codex.
Where do I scan the QR?
Open Machines in the iPhone app, tap Scan QR, and point the camera at the page owodex Agent opened on your Mac.
Can I use a real iPhone instead of Simulator?
Yes. Use a LAN address or Tailscale address that your iPhone can reach.
Does owodex replace Codex?
No. owodex is the phone control surface and Mac bridge for the Codex setup you already use.