Statics Dev

Copy one command, then let Codex page your phone when a turn finishes.

Run the setup command from anywhere inside your local flux checkout. It updates your local ~/.codex/config.toml, installs the notify hook, and immediately starts the OIDC login flow against this backend.

Authentik OIDCCodex notify hookAPNs delivery

One-Line Setup

Configure this Mac for Codex push notifications

Run this inside your cloned flux repo. The browser login will open automatically.

REPO_ROOT="$(git rev-parse --show-toplevel)" && node "$REPO_ROOT/apps/corp-devhelper/bin/codex-notify.mjs" setup --backend-url https://devhelper.corp.statics.ai

What It Changes

Your local Codex config becomes push-aware.

The helper prepends itself to the top-level notify command list and makes sure tui.notifications is enabled. It then stores the refreshed OIDC session under ~/.codex/statics-dev-helper/session.json.

notify = ["${REPO_ROOT}/apps/corp-devhelper/bin/codex-notify.mjs"]

[tui]
notifications = true

After Setup

Verify the helper is signed in.

If the OIDC flow finishes cleanly, this reports the authenticated subject, expiry, and the backend URL currently attached to your local helper session.

REPO_ROOT="$(git rev-parse --show-toplevel)" && node "$REPO_ROOT/apps/corp-devhelper/bin/codex-notify.mjs" status

Device Pairing

Finish from the iPhone app.

Open Statics Dev, sign in with the same OIDC account, allow notifications, and register the device. After that, completed Codex turns on this machine will fan out to the phone through APNs.

  • CLI helper identity and iOS identity must resolve to the same OIDC subject.
  • The backend URL for this environment is https://devhelper.corp.statics.ai.
  • If you move your checkout, rerun the one-line setup command so the hook path stays correct.