Codex
The Codex provider connects Coeus to OpenAI's Codex CLI. Like the Claude Code provider, it runs as an agent on your machine and can read and write files in your notes folder.
What you need
The OpenAI Codex CLI installed and authenticated. Codex requires a ChatGPT Plus or Teams subscription.
Install it with:
npm install -g @openai/codex
codex login
Setup
- Open Settings → AI Providers
- Find Codex and click Configure
- Choose Managed (lets Coeus handle the connection) or Manual (if you want to point to a custom Codex binary)
- Click Connect: Coeus will verify Codex is available and authenticated
How it's different from the OpenAI API
The Codex CLI runs locally on your machine and can interact with your file system. It's an agent, not just an API call. It can navigate your notes folder, create files, and do multi-step work.
The OpenAI API provider is simpler and cheaper for basic Q&A. Codex is worth it when you want the AI to do more on its own.
Reconnecting
If your Codex session expires, run codex login in your terminal to re-authenticate, then reconnect in Coeus settings.