> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mains.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

The OpenAI Codex agent runtime in Mains communicates with the Codex app server via JSON-RPC over stdio. These settings control sandbox isolation, network access, code review, and more.

## **Sandbox Mode**

Controls file and network isolation for the Codex agent during runs.

| **Mode**            | **Description**                                           |
| ------------------- | --------------------------------------------------------- |
| **Read Only**       | Agent cannot modify files                                 |
| **Workspace Write** | Agent can write files within the workspace only (default) |
| **Full Access**     | No restrictions -- agent has full filesystem access       |

<Warning>
  **Full Access** mode disables all file isolation. Only use this in trusted environments where the agent should have unrestricted access to the filesystem.
</Warning>

## **Network Access**

Toggle network access within `workspace-write` sandbox mode. When enabled, the agent can make outbound network requests during runs. Disabled by default in `read-only` mode.

## **Web Search**

Allow the agent to search the web during runs. When enabled, the agent can fetch live search results to inform its responses and code generation.

## **Skip Git Check**

By default, Codex requires the workspace directory to be a Git repository. Enable this option to allow running in non-git directories.

## **Code Review**

Codex supports a native review mode. You can request a structured code review that analyzes workspace changes and produces findings with severity ratings.

Review targets:

| **Target**              | **Description**                            |
| ----------------------- | ------------------------------------------ |
| **Uncommitted changes** | Review all unstaged and staged changes     |
| **Base branch**         | Review changes relative to the base branch |
| **Specific commit**     | Review changes from a specific commit      |
| **Custom**              | Review with a custom diff range            |

Findings are parsed from the Codex output with priority levels (P1 = critical, P2 = warning, P3 = info) and saved as structured [review findings](/reviews).

## **Session Management**

Codex runs support the full session lifecycle:

* **Continue** -- resume a previous session to pick up where you left off

## **Account & Rate Limits**

View your Codex account information and current rate limit status from the settings panel. Rate limits are retrieved from the Codex app server and displayed per-model.