Install Codex CLI
If you already use Codex on the Mac, this page is closer to a verification checklist than an installation guide. CodexPocketMac depends on the Mac-side Codex environment, so the codex command must be visible.
Commands to check
Run these in Terminal:
which codex
codex app-server --help
The expected results are:
which codexprints a pathcodex app-server --helpdoes not fail
Even when codex was installed with Homebrew, which codex may print a symlink under bin, such as /opt/homebrew/bin/codex or /usr/local/bin/codex. To confirm where it came from, inspect that path too:
CODEX_PATH="$(which codex)"
ls -l "$CODEX_PATH"
If the ls -l target, or the which codex result itself, points into /opt/homebrew/Caskroom/... or /usr/local/Caskroom/..., it is installed as a Homebrew cask.
If it does not work
- if
which codexis empty, revisit the Codex CLI installation or PATH - if it works in Terminal but the Mac app does not detect it, restart the Mac app
- you can also inspect the
Codex CLIrow inDetails
What this enables
- starting Bridge
- fetching the
Threadlist for eachProject - using
ComposerandForkfrom the iPhone
If Codex CLI is missing, the iPhone may reach the connection stage, but it will not get as far as doing real work.