v1.0.5

Fixed

• Windows command line limit and special character escaping: Fix bug where long prompts or prompts containing special characters (Chinese text, newlines, backticks, template literals) would fail on Windows due to command line length limits (~8191 chars) and shell escaping issues. Prompts are now passed via stdin instead of command line arguments. (#22)

Changed

• Update @openai/codex optional dependency from ^0.77.0 to ^0.87.0

---

Full Changelog: v1.0.4...v1.0.5

v1.0.4

Fixed

• Image + prompt argument parsing: Fix bug where using images with streamText caused "No prompt provided via stdin" error. Codex CLI's --image flag uses greedy argument parsing (num_args = 1..), which consumed the prompt text as an additional image path. Now adds '--' separator before the prompt when images are present to explicitly mark end of flags. (#19)

---

Installation (AI SDK v6):

npm install ai-sdk-provider-codex-cli ai@^6.0.0

v0.7.3 (AI SDK v5)

Fixed

• Image + prompt argument parsing: Fix bug where using images with streamText caused "No prompt provided via stdin" error. Codex CLI's --image flag uses greedy argument parsing (num_args = 1..), which consumed the prompt text as an additional image path. Now adds '--' separator before the prompt when images are present to explicitly mark end of flags. (#19)

---

Note: This release is for AI SDK v5 users. For AI SDK v6, use v1.0.4 or later.

npm install ai-sdk-provider-codex-cli@ai-sdk-v5 ai@^5.0.0

v1.0.3

Fixed

• codexPath executable support: Fix bug where providing an explicit codexPath to a native executable (e.g., Homebrew's /opt/homebrew/bin/codex) was incorrectly executed via node, causing SyntaxError: Invalid or unexpected token. Now correctly distinguishes between JS entrypoints (.js, .mjs, .cjs) and native executables. (#15)

Install

npm install ai-sdk-provider-codex-cli

---

Full Changelog: v1.0.2...v1.0.3

v0.7.2 (AI SDK v5)

Fixed

• codexPath executable support: Fix bug where providing an explicit codexPath to a native executable (e.g., Homebrew's /opt/homebrew/bin/codex) was incorrectly executed via node, causing SyntaxError: Invalid or unexpected token. Now correctly distinguishes between JS entrypoints (.js, .mjs, .cjs) and native executables. (#15, #16)

Install

npm install ai-sdk-provider-codex-cli@ai-sdk-v5

---

Full Changelog: v0.7.1...v0.7.2

v1.0.2

Added

• GPT-5.2 model support: Add gpt-5.2, gpt-5.2-codex, and related model slugs to documentation
• 'none' reasoning effort: Add 'none' to ReasoningEffort type - the default for GPT-5.1+ models (no extra reasoning). 'minimal' retained as backwards-compatible alias for older GPT-5 slugs.

Install

npm install ai-sdk-provider-codex-cli@1.0.2

v1.0.1

Changes

• Update @openai/codex optional dependency from ^0.60.1 to ^0.77.0

Removed

• BREAKING: Remove includePlanTool setting - The --include-plan-tool CLI flag was removed in Codex CLI 0.48.0 (Oct 2025). The plan tool is now always enabled by default; no configuration needed.

Fixed

• Fix streaming-multiple-tools.mjs example where part.input could be an object instead of a string

Migration

If you were using includePlanTool: true, simply remove it from your configuration. The plan tool now works automatically.

npm install ai-sdk-provider-codex-cli@1.0.1

v1.0.0 - AI SDK v6 Stable

AI SDK v6 Stable Release

This release upgrades the provider to AI SDK v6 stable.

Breaking Changes

• LanguageModelV2 → LanguageModelV3
• ProviderV2 → ProviderV3
• finishReason format: 'stop' → { unified: 'stop', raw: undefined }
• Usage format: flat → nested structure with inputTokens.total, outputTokens.total, and raw field

Changed

• Dependencies updated to stable versions:
  • @ai-sdk/provider: ^3.0.0
  • @ai-sdk/provider-utils: ^4.0.1
  • ai (dev): ^6.0.3

For AI SDK v5 Users

Continue using the v5-compatible version:

npm install ai-sdk-provider-codex-cli@ai-sdk-v5 ai@^5.0.0

Version Compatibility

Provider Version	AI SDK Version	NPM Installation
1.x.x	v6	npm i ai-sdk-provider-codex-cli ai@^6.0.0
0.x.x	v5	npm i ai-sdk-provider-codex-cli@ai-sdk-v5 ai@^5.0.0

v0.7.1 (AI SDK v5)

Added

• GPT-5.2 model support: Add gpt-5.2, gpt-5.2-codex, and related model slugs to documentation
• 'none' reasoning effort: Add 'none' to ReasoningEffort type - the default for GPT-5.1+ models (no extra reasoning). 'minimal' retained as backwards-compatible alias for older GPT-5 slugs.

Install

For AI SDK v5 users:

npm install ai-sdk-provider-codex-cli@ai-sdk-v5

v1.0.0-beta.1

AI SDK v6 Beta Release

This release migrates the provider to AI SDK v6 (beta). It is incompatible with AI SDK v5.

Breaking Changes

• AI SDK v6 migration - Requires AI SDK v6 (beta) packages
• Provider interface: LanguageModelV2 → LanguageModelV3, ProviderV2 → ProviderV3
• Specification version: specificationVersion changed from 'v2' to 'v3'
• Warning format: Changed from { type: 'unsupported-setting', setting: ... } to { type: 'unsupported', feature: ... }
• Usage structure: Changed from flat to hierarchical format
• Method rename: textEmbeddingModel() → embeddingModel()

Installation

npm i ai@beta ai-sdk-provider-codex-cli@beta

Dependencies

• @ai-sdk/provider: 3.0.0-beta.26
• @ai-sdk/provider-utils: 4.0.0-beta.51
• ai (dev): 6.0.0-beta.156

Notes

• This beta release tracks AI SDK v6 beta and will be maintained separately until AI SDK v6 is stable
• For AI SDK v5 users, continue using the 0.x releases (npm i ai-sdk-provider-codex-cli)