Codex Launcher - IntelliJ Plugin

[!IMPORTANT] Codex is now officially integrated into JetBrains IDEs. Install the official integration: https://developers.openai.com/codex/ide/#jetbrains-ide-integration.

With an official integration now available, this plugin is expected to transition to maintenance-only mode.

Codex Launcher is an unofficial IntelliJ IDEA plugin that keeps the OpenAI Codex CLI one click away inside the IDE.

Important: Install the OpenAI Codex CLI separately before using this plugin.

For Windows users: Please select your terminal shell in the plugin settings to ensure proper functionality. Go to Settings (→ Other Settings) → Codex Launcher.

✨ Features

• One-click launch from the toolbar or Tools menu
• Integrated terminal that opens a dedicated "Codex" tab in the project root
• Completion notifications after Codex CLI finishes processing the current run
• Automatic file opening for files updated by Codex
• Built-in MCP server pairing with guided setup for IntelliJ's MCP server (2025.2+)
• Flexible configuration for launch modes, models, and notifications

🛠️ Installation

Prerequisites

• IntelliJ IDEA 2024.2 or later (or other compatible JetBrains IDEs)
• OpenAI Codex CLI installed and available in your system PATH

Installation

🚀 Usage

Quick Start

1. Click the Launch Codex button in the main toolbar.
2. Or choose Tools → Launch Codex.
3. The integrated terminal opens a new "Codex" tab and runs codex automatically.

Configuration

Open Settings (→ Other Settings) → Codex Launcher to pick the launch mode, model, notification behavior, and auto-open options.

📝 Development

Building from Source

git clone https://github.com/x0x0b/codex-launcher.git
cd codex-launcher
./gradlew buildPlugin

📄 License

This project is licensed under the terms specified in the LICENSE file.