Codex (OpenAI)

Built-in

OpenAI's Codex agent. Blueprint Stack communicates with Codex through the codex-acp adapter, which bridges the Codex CLI with the JSON-RPC protocol over stdio.

Installation

1. Install Codex CLI

npm install -g @openai/codex

2. Install ACP adapter

npm install -g @zed-industries/codex-acp

The ACP adapter bridges the Codex CLI with Blueprint Stack's JSON-RPC protocol. The executable name is codex-acp.

3. Authenticate

# Interactive login

codex login

# Or set the API key directly

export OPENAI_API_KEY=your-key-here

Get an API key from platform.openai.com/api-keys.

4. Verify installation

codex --version && codex-acp --help

Both commands should succeed. If codex-acp is not found, ensure your npm global bin directory is in your PATH.

Supported Models

-
GPT-4Strong general reasoning and code generation.
-
o3Advanced reasoning model with chain-of-thought.
-
o4-miniFaster reasoning model, lower cost.

Features

-Streaming - Responses stream in real time into the chat panel.
-Sandboxing - Codex runs code in a sandboxed environment by default for safety.
-Auto-detection - Blueprint Stack automatically detects the codex-acp executable from your PATH, npm global bin, bun, cargo, volta, fnm, asdf, mise, scoop, and Homebrew directories.

Requirements

-Node.js 18+
-OpenAI API key with access to GPT-4 / o3 / o4-mini
-Codex CLI installed (codex)
-ACP adapter installed globally (codex-acp)