llm-openai-codex 0.2.3

Access OpenAI models via a Codex subscription

llm-openai-codex

LLM plugin for accessing ChatGPT/Codex-backed OpenAI models through the Responses API.

This project is forked from and based on Simon Willison's llm-openai-via-codex.

Changes from the original plugin

• Package renamed to llm-openai-codex.
• Model prefix changed to codex/.
• Plugin-owned auth is stored in LLM's user config directory as auth-codex.json, with borrowed fallback to ${CODEX_HOME:-~/.codex}/auth.json.
• llm codex auth commands manage login, import, status, refresh, and logout.
• Explicit verbosity option maps to Responses API text.verbosity.
• Extra Responses API options are forwarded when LLM accepts them.
• Missing account_id values are derived from OAuth JWT claims when possible.
• Added llm codex usage showing current Codex plan usage.
• Registers known hidden/fallback Codex models such as gpt-5.3-codex-spark.

Installation

Install this plugin in the same environment as LLM.

llm install llm-openai-codex

Usage

Authenticate the plugin:

llm codex login [--device-code]

If you already use Codex CLI, the plugin can fall back to ${CODEX_HOME:-~/.codex}/auth.json when auth-codex.json does not exist. You can also copy those tokens into plugin-owned auth with llm codex import.

List available Codex-backed models:

llm models -q codex

Models are discovered from the Codex API, plus known hidden/fallback slugs such as gpt-5.3-codex-spark. Some listed fallback models may still fail at request time if your plan lacks access.

Run a prompt:

llm -m codex/gpt-5.3-codex-spark "Hello"

Use Responses API verbosity:

llm -m codex/gpt-5.3-codex-spark -o verbosity low "Summarize this"

Auth commands

llm codex login
llm codex login --device-code
llm codex status
llm codex refresh
llm codex refresh --borrowed
llm codex usage
llm codex import
llm codex logout

Auth source order:

1. Plugin-owned auth-codex.json
2. Borrowed Codex CLI auth at ${CODEX_HOME:-~/.codex}/auth.json

llm codex import copies ChatGPT OAuth tokens from Codex CLI auth into plugin-owned auth-codex.json. It refuses to overwrite an existing auth-codex.json; run llm codex logout first if you want to replace plugin-owned auth.

Refresh behavior

• Plugin-owned auth refreshes lazily and on demand via llm codex refresh.
• Borrowed Codex CLI auth never refreshes automatically. When it expires, pick one:
  • llm codex refresh --borrowed — refresh the shared file in place. Rotates the shared refresh_token; restart any running Codex CLI session afterwards.
  • Run Codex CLI itself to refresh.
  • llm codex import to promote it to plugin-owned auth.

llm codex status shows which auth source is active.

When authentication is missing or expired, run llm codex login [--device-code] or llm codex import.

Development

uv run pytest
uv run llm plugins
uv run llm codex status