TheStreamCode/codex-cli-launcher

Codex CLI Launcher

Launch OpenAI Codex CLI in a fresh side terminal directly from the VS Code editor toolbar.

Install from Visual Studio Marketplace · Install from Open VSX

Latest GitHub release: v0.1.10

Codex CLI Launcher is a small, unofficial VS Code extension for developers who already use Codex CLI and want a predictable one-click launcher inside the editor. It works on Windows, macOS, and Linux wherever codex is available to the integrated terminal.

Unofficial project: This extension is not affiliated with, endorsed by, sponsored by, or approved by OpenAI. "OpenAI", "Codex", and related names are trademarks of their respective owners.

Features

• Launch Codex CLI from the editor title with one click
• Open a fresh side terminal for every launch instead of reusing existing sessions
• Start in the active editor's workspace, with a predictable fallback for multi-root windows
• Configure the launch command and terminal name without repository-controlled overrides
• Links to the official Codex CLI installation documentation when the default codex command is not available
• Supports quoted Windows executable paths, including PowerShell's call operator

• Does not collect telemetry, analytics, or personal data

Quick Start

• Install Codex CLI using the official Codex CLI documentation.
• Install Codex CLI Launcher from the Visual Studio Marketplace or Open VSX.
• Open a file in a trusted workspace.
• Click the launcher button in the editor title.

VS Code users can also install the extension from a terminal:

code --install-extension mikesoft.vscode-codex-cli-launcher

Trust and Privacy

• The launcher is disabled until the workspace is trusted.
• The CLI command is machine-scoped and cannot be supplied by a repository.
• The extension never downloads Codex CLI, generates installer scripts, or runs package-manager installation commands.
• Shell-output capture is bounded and used only to recognize a missing default codex command. Output from custom commands is not read.
• No telemetry, analytics, or personal data is collected.
• All extension artwork is packaged in the VSIX; no external images are loaded at runtime.

See SECURITY.md and the architecture documentation for the maintained trust boundaries.

Compatibility

| Environment | Status | | --- | --- | | VS Code ^1.103.0 | Supported and covered by the minimum-version integration test | | Windows | Supported and validated in CI | | Linux | Supported and validated in CI | | macOS | Supported; not currently included in the CI matrix | | Other VS Code-compatible editors | May work when they provide the required VS Code APIs, but are not part of the supported test matrix |