Skip to content

Agents > Third-Party CLI Agents

Codex CLI in Warp

Open in ChatGPT ↗
Ask ChatGPT about this page
Open in Claude ↗
Ask Claude about this page
Copied!

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.

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.

For installation, authentication, project configuration, and productivity tips, see the How to set up Codex CLI guide.

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 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:

Terminal window
codex plugin marketplace add warpdotdev/codex-warp
codex plugin add warp@codex-warp

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

Terminal window
codex plugin marketplace upgrade codex-warp
codex plugin add warp@codex-warp

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).
  • 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.