Skip to guide

Use onemind with Codex

OpenAI renamed the Codex app to ChatGPT; onemind shows it as ChatGPT and keeps the codex target and CLI command.

Codex works with the onemind macOS app and CLI. onemind writes one server-composed package to AGENTS.md in the explicitly bound Project directory. Native BETA sync also maintains a stable user-wide bootstrap in ~/.codex/AGENTS.md; Project content stays in the bound folder.

macOS app

  1. Sign in to OneMind BETA.app and connect Codex from Team where the host supports verified Connect.
  2. Open Mind, choose the intended Project, and bind its exact folder on this Mac.
  3. Open the approved Mind, choose Sync, check the tool/device, and choose Sync now. Wait for confirmed delivery.
  4. Start a fresh Codex task from that folder. See Mind Sync for pending, offline, and recovery states.

The native app manages its own connection and folder binding; CLI repository detection is a separate terminal workflow.

CLI

From the repository you use with Codex, run:

onemind project codex .

The CLI detects Codex and prints a message asking you to open onemind and choose the Project Mind for the detected folder. Open the onemind app, find the detected folder in Sync Setup, and bind it to the intended Project Mind. Then run:

onemind sync
onemind status

Confirm the onemind-managed Codex section in <repository>/AGENTS.md. On the first write, onemind saves the previous file at <repository>/.one-mind/AGENTS.md.backup. Start a fresh Codex task in that repository.

The CLI composes Team and Project content in its Project package. Retire old global content bindings only through their explicit migration flow; do not remove the native bootstrap.

Codex skills are installed as part of the native plugin integration. Use onemind integrations install codex to install or update the integration.

While a Codex task is running, tool permission requests appear in Matrix. As the device owner, you can answer them in Matrix or the macOS app without stopping the task.