Skip to main content
Mains uses your installed Codex CLI and its app server. Install Codex, sign in with codex login, and open Settings → Codex. Codex supports Code, Work, Chat, and Atlas. Mains reports an incompatible or outdated CLI in provider settings. The current integration accepts 0.153.0 or newer and is developed against 0.160.0; newer features can need a newer CLI than the minimum.

Model and effort

Models and supported effort levels come from the runtime and your account. Choose them in the composer. Mains keeps each conversation’s choices and remembers explicit preferences for new chats. Effort choices vary by model. Fast mode uses Codex’s fast service tier when available. Plan and Goal controls appear where the selected Mains mode supports them.

Sandbox mode

Selecting Full Access opens a confirmation describing access to files, terminal commands, the internet, and connected apps. Approval policy remains a separate setting. Full Access does not mean every connected service will authorize every action.

Approval policy

Read requests in Approvals. Organizational policy can restrict these choices. Network Access controls outbound access for workspace-write execution. Web Search controls the provider’s web-search capability. They are different controls. Skip Git Check lets a run use a non-Git directory when applicable. Work already uses a managed execution directory and its own mode policy. Work applies workspace-write and hides developer permission controls. Chat enforces read-only access. Existing runs retain their mode.

Conversation memory

Under Conversation memory, you can:
  • Turn Use saved memories on or off.
  • Choose whether to Include chats that use tools, including MCP or web search.
  • Clear saved memories on this device after confirming.
These controls manage Codex memory, not Mains’s chat history or Atlas Pages. A runtime or managed policy that does not support a control is reported in Settings.

Other capabilities

Codex supports continue and fork, native review, subagents, queue and steering, voice, plugins, and MCP apps. Account usage and available limits appear in Settings when reported by Codex. They remain separate from Mains’s local usage estimates.