> For the complete documentation index, see [llms.txt](/llms.txt).
> Markdown versions of each page are available by appending .md to any URL.

# Codex CLI in Warp

Set up Codex in Warp with notification support, rich input, code review, and more.

Codex is OpenAI’s open-source coding agent that runs in your terminal. It can write and edit code, execute commands, and navigate your codebase through natural language. For full documentation, see the [Codex GitHub repository](https://github.com/openai/codex).

Warp auto-detects Codex when you run it, giving you access to rich input controls, code review, and other integrated features. For a product overview, see [Codex in Warp](https://www.warp.dev/agents/codex).

For installation, authentication, project configuration, and productivity tips, see the [How to set up Codex CLI](/guides/external-tools/how-to-set-up-codex-cli/) guide.

Note

Codex is also available as a harness in Oz for cloud orchestration. See [Codex with Oz](/platform/harnesses/codex/).

## Setting up notifications

Warp surfaces Codex activity as in-app and desktop alerts — such as when Codex completes a task, encounters an error, or needs your input. This is powered by the Warp plugin for Codex, published from the [warpdotdev/codex-warp](https://github.com/warpdotdev/codex-warp) plugin marketplace.

When Warp detects a Codex session without the plugin, it shows an install chip in the terminal. Click the chip to install the plugin, then restart Codex. Warp shows an update chip the same way when a newer plugin version is required.

To install the plugin yourself, add the marketplace and the plugin:

```
codex plugin marketplace add warpdotdev/codex-warpcodex plugin add warp@codex-warp
```

Restart Codex to activate the plugin. To update it later, upgrade the marketplace and reinstall the plugin:

```
codex plugin marketplace upgrade codex-warpcodex plugin add warp@codex-warp
```

Note

If you point `codex-warp` at a local (non-Git) marketplace source, Warp leaves that override alone and doesn’t offer plugin updates for it.

## Supported Warp features

Codex supports the full set of Warp’s agent integration features:

-   **Agent notifications** - Receive in-app and desktop alerts when Codex needs your attention. Requires the Warp plugin for Codex (see [Setting up notifications](#setting-up-notifications)).
-   **Rich input editor** - Press `Ctrl-G` to open an expanded input editor for composing longer prompts.
-   **Code review** - Send inline review comments directly to the agent from Warp’s code review panel.
-   **Attach code as context** - Select code and send it to the agent as context.
-   **Vertical tabs with agent metadata** - Monitor Codex sessions with status indicators in Warp’s tab bar.
-   **Tab Configs** - Save and restore Codex session configurations.
-   **Remote Control** - Share your Codex session with teammates via session sharing.

## Related pages

-   [How to set up Codex CLI](/guides/external-tools/how-to-set-up-codex-cli/) — step-by-step setup guide
-   [Codex in Warp](https://www.warp.dev/agents/codex) — product overview
-   [Third-party CLI agents overview](/agent-platform/cli-agents/overview/) — supported CLI agent integrations
-   [Codex with Oz](/platform/harnesses/codex/) — Codex as a cloud harness
-   [Claude Code](/agent-platform/cli-agents/claude-code/) — Claude Code in Warp
-   [OpenCode](/agent-platform/cli-agents/opencode/) — OpenCode in Warp