Supported Environments
The current CodexPocket release targets the setup where an iPhone opens Codex running on a Mac. First setup happens on the same local network, and after setup, Managed Relay can connect from another Wi-Fi network or mobile data. This page organizes what combinations are supported, partially supported, or out of scope for now.
Supported combinations
| Item | Status | Notes |
|---|---|---|
| Mac | Supported | macOS 26 or later |
| iPhone | Supported | physical devices running iOS 26 or later |
| Mac and iPhone on the same local network | Supported | used for first setup and local connections |
| Another Wi-Fi network or mobile data through Managed Relay | Supported | automatically used when Relay information is saved for the Host |
| Mac environment where Codex runs | Supported | CodexPocketMac uses Codex on the Mac |
| Japanese / English UI | Supported | can be switched inside the app |
Partially supported cases
| Item | Status | Notes |
|---|---|---|
Macs without git | Partial | basic actions may still work, but Git-dependent features such as branch actions do not |
| Pairing without QR | Partial | even if the camera is unavailable, adding by pasting a pairing code is possible |
Currently out of scope
| Item | Status | Reason |
|---|---|---|
| iPad | Unsupported | the current iOS app is designed for iPhone |
| Android | Unsupported | the current mobile app is iPhone-only |
| Mac-only client flow | Unsupported | CodexPocket assumes the iPhone is the control surface |
| Internet-facing connections without Managed Relay | Unsupported | directly exposing a Bridge URL is outside the supported scope |
| Mobile-data connections without Managed Relay setup | Unsupported | first set up the Host on the same local network |
How to judge quickly
If the following are true, you are within the intended scope:
- the Mac is on
macOS 26or later - the iPhone is on
iOS 26or later - Codex already works normally on the Mac
- during first setup, the Mac and iPhone are on the same local network
- the Host you want to use from another Wi-Fi network or mobile data has Managed Relay information saved
If you want to connect from another network without Managed Relay, or use an iPad, that is out of scope in the current release.