<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> This plugin enables opencode to use personal ChatGPT Plus/Pro subscriptions for coding assistance, serving as an alternative to OpenAI Platform API credits. It targets individual developers seeking to leverage existing subscriptions for enhanced terminal-based productivity.

How It Works

The project integrates with opencode via OpenAI's official OAuth authentication, mirroring the Codex CLI's method. This allows users to authenticate with ChatGPT Plus/Pro credentials, enabling GPT-5 and Codex models without API keys. It manages token refresh and offers configurable reasoning levels.

Quick Start & Requirements

• Installation: Add "opencode-openai-codex-auth" to your opencode configuration; opencode installs it automatically.
• Prerequisites: ChatGPT Plus/Pro subscription, opencode installed (opencode.ai). Authenticate via opencode auth login selecting "ChatGPT Plus/Pro (Codex Subscription)".
• Links: opencode.ai, OpenAI OAuth.

Highlighted Details

• Leverages official ChatGPT Plus/Pro OAuth, eliminating API key management.
• Provides 9 pre-configured model variants with adjustable reasoning (low, medium, high) for GPT-5 and GPT-5-Codex.
• Features auto-refreshing tokens and ETag-cached instruction updates.
• Supports full tool integration (write, edit, bash, grep, glob) with automatic remapping.
• Includes extensive testing (159 unit, 14 integration tests) and a type-safe TypeScript codebase.

Maintenance & Community

Maintained by numman-ali (@nummanthinks on X). No dedicated community channels (Discord/Slack) are listed. The project's test coverage suggests a focus on stability.

Licensing & Compatibility

MIT licensed. Strictly for personal development use; prohibits commercial API resale, white-labeling, or multi-user services. Commercial use requires the OpenAI Platform API.

Limitations & Caveats

Strictly for personal coding assistance; not for commercial services, API resale, or high-volume automation. Users must comply with OpenAI's terms and rate limits, as excessive use may incur throttling. The plugin does not bypass rate limits. Updates require manual cache clearing and opencode restarts. Port conflicts exist if the Codex CLI is running.