Connect AIType to Codex

The Codex keyboard button sends your voice task to your own Mac. AIType does not route public users into a shared Codex worker, and users do not need to map one button to one folder.

Your AIType accountYour Codex loginYour Mac worker

How it works

  1. Your iPhone or Android keyboard sends the spoken task to your AIType account queue.
  2. Your Mac worker polls only tasks for the AIType account that installed it.
  3. The worker creates a visible Codex thread through the local Codex app-server on your Mac.
  4. Codex runs from your Mac account so it can find the relevant local project or repo across your codebase.
  5. AIType-created Codex threads default to GPT-5.5 Extra High unless the Mac worker operator overrides that worker setting.
  6. The task runs with the Codex permissions configured on your Mac. AIType does not borrow another user's Codex session.

Mac setup

  1. Install Codex on your Mac, sign in, and confirm codex --version works in Terminal.
  2. Sign into ChatGPT or Codex on your phone with the same OpenAI account and confirm this Mac appears as a Codex device.
  3. Open your AIType account on the Mac and copy the App Access Key that starts with ait-.
  4. Run this in Terminal and paste that key when asked. The installer starts the local Codex app-server and connects AIType to that Mac.
curl -fsSL https://aitype.work/api/codex/setup/macos | bash

iPhone

  1. Install AIType, sign in with the same AIType account, enable the AIType keyboard, and allow full access.
  2. Open any app with a text field and switch to AIType.
  3. Hold the Codex button in the top toolbar, speak the task, then release.
  4. Open ChatGPT or Codex on iPhone to see the new thread under the connected Mac. The keyboard confirms handoff; Codex continues the task inside that thread.

Android

  1. Install AIType, sign in with the same AIType account, enable the AIType keyboard, and allow microphone access.
  2. Open any app with a text field and switch to AIType.
  3. Hold the Codex button in the top toolbar, speak the task, then release.
  4. Open ChatGPT or Codex on your phone to see the new thread under the connected Mac. The keyboard confirms handoff; Codex continues the task inside that thread.

Troubleshooting

  1. If the Codex button says it is queued, keep the Mac awake and online.
  2. If no thread appears, run codex app-server daemon version on the Mac and confirm it reports running.
  3. If the thread appears but looks quiet, keep the thread open or reopen it. Codex may still be building, deploying, or running checks in that thread after the first status message.
  4. If the wrong account is connected, rerun the installer and paste the App Access Key from the AIType account used on the phone.
  5. If you sell or share the Mac, remove ~/.config/aitype-codex-worker/env and unload com.aitype.codex-task-worker.