Welcome to the OpenCode OpenAI Codex Auth Plugin documentation!
- Getting Started - Installation, configuration, and quick start
- Configuration Guide - Complete config reference
- Troubleshooting - Common issues and debugging
- Changelog - Version history and release notes
Explore the engineering depth behind this plugin:
- Architecture - Technical design, request pipeline, AI SDK compatibility
- Configuration System - How config loading and merging works
- Config Fields Guide - Understanding config keys,
id, andname - Testing Guide - Test scenarios, verification procedures, integration testing
This plugin bridges two different systems with careful engineering:
- AI SDK Compatibility - Filters
item_reference(AI SDK construct) for Codex API compatibility - Stateless Operation - ChatGPT backend requires
store: false, verified via testing - Full Context Preservation - Sends complete message history (IDs stripped) for LLM context
- 15-Minute Caching - Prevents GitHub API rate limit exhaustion
- Per-Model Configuration - Enables quality presets with quick switching
Testing: 200+ unit tests + integration tests with actual API verification