Skip to content

x0x0b/codex-launcher

Repository files navigation

Codex Launcher - IntelliJ Plugin

Version IntelliJ IDEA Ask DeepWiki

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.

The screenshot of Codex Launcher.

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

Install Plugin

🚀 Usage

Quick Start

  1. Click the Launch Codex button in the main toolbar.
  2. Or choose ToolsLaunch 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.

About

🧩 One-click Codex launcher for IntelliJ

Topics

Resources

License

Stars

52 stars

Watchers

0 watching

Forks

Contributors

Languages