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

# OpenAI Codex Support

> Trunk Code Quality for OpenAI Codex

This document provides guidance for integrating Trunk Code Quality into OpenAI Codex environments.

### Requirements

Ensure you’re running the following minimum versions in your `.trunk/trunk.yaml` file:

* Trunk CLI: v1.24.0 or later
* Trunk Plugins: v1.7.0 or later

### Installation

In your Codex environment setup script, include:

```
# Install Trunk CLI and dependent tools
curl https://get.trunk.io -fsSL | bash
trunk install
```

It's important to pre-install all trunk dependencies during the setup because codex environments are network-isolated post-setup.

#### Debugging installation

If the environment setup is slow, run the following to diagnose:

```
trunk install --debug
```

This command will detail installation timings and potential bottlenecks.

### Handling network isolation

Codex environments are network-isolated post-setup. Linters requiring network access must be excluded from running explicitly:

Example:

```
trunk check --filter=-trufflehog,-semgrep
```

### Teaching Codex how to use Trunk

Codex can automatically run trunk commands for you, by informing it to do so in your AGENTS.md file:

```
## AGENTS Instructions

### Formatting and Linting
- Run `trunk check -y --filter=-trufflehog,-semgrep` after modifying code to format and fix linting issues.
- Review and verify changes before committing.
- If only formatting is required, run `trunk fmt`.
- Exclude linters requiring network access by adding them to the negative filter list as shown above.
```