Menu bar first
The Mac app prepares the local connector, watches pairing health, and publishes itself for nearby iPhones.
Codex from your iPhone.
Install the Godex menu bar app on your Mac, open Godex on iPhone, and connect automatically on the same network.
Requires macOS and Codex installed on this Mac. Pairing code stays available as a fallback.
Godex
Mac found
Open the Mac app. Your iPhone handles the rest.
Godex discovers your Mac locally, refreshes pairing when needed, and connects without terminal setup screens.
1
DownloadMove Godex to Applications and open it from the menu bar.
2
Stay localKeep Mac and iPhone on the same Wi-Fi network.
3
ConnectOpen Godex on iPhone. It finds the Mac automatically.
A setup flow built around the Mac app.
Automatic discovery
The iPhone looks for Godex on the same local network and connects through the Mac setup window.
Simple fallback
If local discovery is blocked, pair with a short setup code from the Mac app.
Local-first by default.
Your Mac runs Codex
Godex is a phone control surface for the Codex runtime already installed on your computer.
Same-network pairing
The Mac advertises a short-lived local pairing session so the phone can connect without scanning.
Encrypted channel
Pairing establishes a secure transport between iPhone and Mac before Codex messages are exchanged.
Help for the Mac and iPhone flow.
Install the Mac app
Download the DMG, move Godex to Applications, and keep the menu bar app open while pairing from iPhone.
Connection checklist
Use the same Wi-Fi network, allow local network access on iPhone, and keep Codex installed on the Mac.
Recovery paths
If automatic discovery is blocked, use pairing code from the app to refresh the trusted Mac.
Privacy.
Local control surface
Godex is designed around your Mac as the runtime. Prompts, Codex tool use, file edits, git actions, and workspace history stay on the Mac running Codex. The website provides downloads and setup information; it does not run your Codex sessions.
Terms.
Use with your own workspace
Godex helps control a local Codex runtime from iPhone. You are responsible for the commands you send, the repositories you connect, and any changes made in your local workspace.