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)