opencode-codex-auth-rotation 1.0.0

package/LICENSE

@@ -0,0 +1,37 @@
+MIT License with Usage Disclaimer
+
+Copyright (c) 2024-2025 numman-ali
+
+USAGE NOTICE AND DISCLAIMER:
+This software is provided for personal development use only. Users must comply
+with OpenAI's Terms of Service (https://openai.com/policies/terms-of-use/) and
+Usage Policies (https://openai.com/policies/usage-policies/) when using this
+software to access OpenAI services.
+
+The authors and contributors are not responsible for any violations of
+third-party terms of service. For commercial use or production applications,
+obtain proper API access from OpenAI directly through the OpenAI Platform
+(https://platform.openai.com/).
+
+This software uses OpenAI's official OAuth authentication system and is not
+affiliated with, endorsed by, or sponsored by OpenAI.
+
+---
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice, usage notice, and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,170 @@
+![Image 1: opencode-openai-codex-auth](assets/readme-hero.svg)
+  
+  
+**Curated by [Numman Ali](https://x.com/nummanali)**
+[![Twitter Follow](https://img.shields.io/twitter/follow/nummanali?style=social)](https://x.com/nummanali)
+[![npm version](https://img.shields.io/npm/v/opencode-openai-codex-auth.svg)](https://www.npmjs.com/package/opencode-openai-codex-auth)
+[![Tests](https://github.com/numman-ali/opencode-openai-codex-auth/actions/workflows/ci.yml/badge.svg)](https://github.com/numman-ali/opencode-openai-codex-auth/actions)
+[![npm downloads](https://img.shields.io/npm/dm/opencode-openai-codex-auth.svg)](https://www.npmjs.com/package/opencode-openai-codex-auth)
+**One install. Every Codex model.**
+[Install](#-quick-start) · [Models](#-models) · [Configuration](#-configuration) · [Docs](#-docs)
+
+---
+## 💡 Philosophy
+> **"One config. Every model."**
+OpenCode should feel effortless. This plugin keeps the setup minimal while giving you full GPT‑5.x + Codex access via ChatGPT OAuth.
+```
+┌─────────────────────────────────────────────────────────┐
+│                                                         │
+│  ChatGPT OAuth → Codex backend → OpenCode               │
+│  One command install, full model presets, done.         │
+│                                                         │
+└─────────────────────────────────────────────────────────┘
+```
+---
+## 🚀 Quick Start
+```bash
+npx -y opencode-openai-codex-auth@latest
+```
+Then:
+```bash
+opencode auth login
+opencode run "write hello world to test.txt" --model=openai/gpt-5.2 --variant=medium
+```
+Legacy OpenCode (v1.0.209 and below):
+```bash
+npx -y opencode-openai-codex-auth@latest --legacy
+opencode run "write hello world to test.txt" --model=openai/gpt-5.2-medium
+```
+Uninstall:
+```bash
+npx -y opencode-openai-codex-auth@latest --uninstall
+npx -y opencode-openai-codex-auth@latest --uninstall --all
+```
+---
+## 📦 Models
+- **gpt-5.2** (none/low/medium/high/xhigh)
+- **gpt-5.2-codex** (low/medium/high/xhigh)
+- **gpt-5.1-codex-max** (low/medium/high/xhigh)
+- **gpt-5.1-codex** (low/medium/high)
+- **gpt-5.1-codex-mini** (medium/high)
+- **gpt-5.1** (none/low/medium/high)
+---
+## 🧩 Configuration
+- Modern (OpenCode v1.0.210+): `config/opencode-modern.json`
+- Legacy (OpenCode v1.0.209 and below): `config/opencode-legacy.json`
+
+Minimal configs are not supported for GPT‑5.x; use the full configs above.
+---
+## ✅ Features
+- ChatGPT Plus/Pro OAuth authentication (official flow)
+- 22 model presets across GPT‑5.2 / GPT‑5.2 Codex / GPT‑5.1 families
+- Variant system support (v1.0.210+) + legacy presets
+- Multimodal input enabled for all models
+- Usage‑aware errors + automatic token refresh
+---
+## 📚 Docs
+- Getting Started: `docs/getting-started.md`
+- Configuration: `docs/configuration.md`
+- Troubleshooting: `docs/troubleshooting.md`
+- Architecture: `docs/development/ARCHITECTURE.md`
+---
+## 🔄 Multi-Account Setup Guide
+
+This plugin supports **multiple ChatGPT accounts** for automatic failover when rate limits occur.
+
+### Configuration
+
+Account credentials are stored in `~/.config/opencode/codex-accounts.json`:
+
+```json
+{
+  "version": 1,
+  "accounts": [
+    {
+      "id": "account-1",
+      "email": "user1@example.com",
+      "accessToken": "YOUR_ACCESS_TOKEN_1",
+      "refreshToken": "YOUR_REFRESH_TOKEN_1",
+      "chatgptAccountId": "chatgpt-account-id-1",
+      "enabled": true
+    },
+    {
+      "id": "account-2",
+      "email": "user2@example.com",
+      "accessToken": "YOUR_ACCESS_TOKEN_2",
+      "refreshToken": "YOUR_REFRESH_TOKEN_2",
+      "chatgptAccountId": "chatgpt-account-id-2",
+      "enabled": true
+    }
+  ],
+  "activeIndex": 0
+}
+```
+
+### Account Rotation Strategies
+
+The plugin supports three rotation strategies:
+
+| Strategy | Description | Best For |
+|----------|-------------|----------|
+| **Sticky** (default) | Stay with current account until rate-limited | Low-volume usage |
+| **Round-Robin** | Rotate sequentially through accounts | Even distribution |
+
+Environment variable: `CODEX_ACCOUNT_STRATEGY=sticky|round-robin`
+
+## 🔄 Usage-Based Account Selection
+
+This plugin selects accounts based on actual ChatGPT usage data from the `/wham/usage` API.
+
+### 30/60/90% Equal Distribution Strategy
+
+1. **Weekly usage buckets**: Accounts are grouped by weekly usage percentage
+   - Bucket 0: 0-30%
+   - Bucket 1: 30-60%
+   - Bucket 2: 60-90%
+   - Bucket 3: 90%+
+
+2. **Selection logic**:
+   - Filter accounts with the lowest weekly bucket
+   - Among those, select the one with lowest 5-hour usage
+   - This ensures all accounts reach similar usage levels before moving to the next bucket
+
+### Usage Debugging
+
+Check current usage for all accounts:
+```bash
+bun run scripts/check-usage.ts
+```
+
+JSON output:
+```bash
+bun run scripts/check-usage.ts --json
+```
+
+### Automatic Failover
+
+When a **429 Rate Limit** error occurs:
+
+1. Current account is marked with `rateLimitResetTime`
+2. Plugin automatically switches to next available account
+3. Rate-limited account is skipped until reset time passes
+
+### Adding Multiple Accounts
+
+1. Run the OAuth flow for each account:
+   ```bash
+   opencode auth login
+   ```
+
+2. The plugin will automatically add new accounts to the configuration.
+
+3. You can manually enable/disable accounts by setting `"enabled": false`.
+
+---
+
+## ⚠️ Usage Notice
+This plugin is for **personal development use** with your own ChatGPT Plus/Pro subscription.
+For production or multi‑user applications, use the OpenAI Platform API.
+
+**Built for developers who value simplicity.**

package/assets/codex-auth.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://github.com/numman-ali/opencode-openai-codex-auth/blob/main/assets/codex-auth.schema.json",
+  "title": "Codex Auth Plugin Configuration",
+  "description": "Configuration schema for opencode-openai-codex-auth plugin",
+  "type": "object",
+  "properties": {
+    "codexMode": {
+      "type": "boolean",
+      "default": true,
+      "description": "Enable CODEX_MODE (Codex-OpenCode bridge prompt instead of tool remap)"
+    },
+    "strategy": {
+      "type": "string",
+      "enum": ["sticky", "round-robin"],
+      "default": "sticky",
+      "description": "Account selection strategy. sticky: stay with current account until rate-limited. round-robin: rotate through accounts based on usage."
+    },
+    "pidOffset": {
+      "type": "boolean",
+      "default": false,
+      "description": "Enable PID-based offset for initial account selection. Distributes starting accounts across parallel processes."
+    }
+  },
+  "additionalProperties": false
+}

package/assets/opencode-logo-ornate-dark.svg

@@ -0,0 +1,18 @@
+<svg width="234" height="42" viewBox="0 0 234 42" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M18 30H6V18H18V30Z" fill="#4B4646"/>
+<path d="M18 12H6V30H18V12ZM24 36H0V6H24V36Z" fill="#B7B1B1"/>
+<path d="M48 30H36V18H48V30Z" fill="#4B4646"/>
+<path d="M36 30H48V12H36V30ZM54 36H36V42H30V6H54V36Z" fill="#B7B1B1"/>
+<path d="M84 24V30H66V24H84Z" fill="#4B4646"/>
+<path d="M84 24H66V30H84V36H60V6H84V24ZM66 18H78V12H66V18Z" fill="#B7B1B1"/>
+<path d="M108 36H96V18H108V36Z" fill="#4B4646"/>
+<path d="M108 12H96V36H90V6H108V12ZM114 36H108V12H114V36Z" fill="#B7B1B1"/>
+<path d="M144 30H126V18H144V30Z" fill="#4B4646"/>
+<path d="M144 12H126V30H144V36H120V6H144V12Z" fill="#F1ECEC"/>
+<path d="M168 30H156V18H168V30Z" fill="#4B4646"/>
+<path d="M168 12H156V30H168V12ZM174 36H150V6H174V36Z" fill="#F1ECEC"/>
+<path d="M198 30H186V18H198V30Z" fill="#4B4646"/>
+<path d="M198 12H186V30H198V12ZM204 36H180V6H198V0H204V36Z" fill="#F1ECEC"/>
+<path d="M234 24V30H216V24H234Z" fill="#4B4646"/>
+<path d="M216 12V18H228V12H216ZM234 24H216V30H234V36H210V6H234V24Z" fill="#F1ECEC"/>
+</svg>

package/assets/readme-hero.svg

@@ -0,0 +1,31 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="300" viewBox="0 0 1200 300" role="img" aria-label="OpenCode Codex OAuth">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#0f172a" />
+      <stop offset="100%" stop-color="#1f2937" />
+    </linearGradient>
+    <linearGradient id="accent" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0%" stop-color="#38bdf8" />
+      <stop offset="100%" stop-color="#22d3ee" />
+    </linearGradient>
+  </defs>
+  <rect width="1200" height="300" rx="28" fill="url(#bg)" />
+  <g opacity="0.12">
+    <circle cx="1020" cy="70" r="120" fill="#38bdf8" />
+    <circle cx="150" cy="260" r="140" fill="#22d3ee" />
+  </g>
+  <g fill="none" stroke="url(#accent)" stroke-width="8" stroke-linecap="round" stroke-linejoin="round">
+    <path d="M160 95 L100 150 L160 205" />
+    <path d="M280 95 L340 150 L280 205" />
+    <path d="M205 80 L235 220" />
+  </g>
+  <text x="420" y="120" fill="#e2e8f0" font-size="42" font-family="'IBM Plex Sans','Segoe UI',Arial,sans-serif" font-weight="600">
+    OpenCode Codex OAuth
+  </text>
+  <text x="420" y="170" fill="#cbd5f5" font-size="24" font-family="'IBM Plex Sans','Segoe UI',Arial,sans-serif">
+    ChatGPT Plus/Pro auth for GPT-5.2 and Codex models
+  </text>
+  <text x="420" y="220" fill="#7dd3fc" font-size="18" font-family="'IBM Plex Sans','Segoe UI',Arial,sans-serif">
+    One-command install, modern variants, full tool support
+  </text>
+</svg>

package/config/README.md

@@ -0,0 +1,103 @@
+# Configuration
+
+This directory contains the official opencode configuration files for the OpenAI Codex OAuth plugin.
+
+## ⚠️ REQUIRED: Choose the Right Configuration
+
+**Two configuration files are available based on your OpenCode version:**
+
+| File | OpenCode Version | Description |
+|------|------------------|-------------|
+| [`opencode-modern.json`](./opencode-modern.json) | **v1.0.210+ (Jan 2026+)** | Compact config using variants system - 6 models with built-in reasoning level variants |
+| [`opencode-legacy.json`](./opencode-legacy.json) | **v1.0.209 and below** | Extended config with separate model entries for each reasoning level - 20+ individual model definitions |
+
+### Which one should I use?
+
+**If you have OpenCode v1.0.210 or newer** (check with `opencode --version`):
+```bash
+cp config/opencode-modern.json ~/.config/opencode/opencode.jsonc
+```
+
+**If you have OpenCode v1.0.209 or older**:
+```bash
+cp config/opencode-legacy.json ~/.config/opencode/opencode.jsonc
+```
+
+### Why two configs?
+
+OpenCode v1.0.210+ introduced a **variants system** that allows defining reasoning effort levels as variants under a single model. This reduces config size from 572 lines to ~150 lines while maintaining the same functionality.
+
+**What you get:**
+
+| Config File | Model Families | Reasoning Variants | Total Models |
+|------------|----------------|-------------------|--------------|
+| `opencode-modern.json` | 6 | Built-in variants (low/medium/high/xhigh) | 6 base models with 19 total variants |
+| `opencode-legacy.json` | 6 | Separate model entries | 20 individual model definitions |
+
+Both configs provide:
+- ✅ All supported GPT 5.2/5.1 variants: gpt-5.2, gpt-5.2-codex, gpt-5.1, gpt-5.1-codex, gpt-5.1-codex-max, gpt-5.1-codex-mini
+- ✅ Proper reasoning effort settings for each variant (including `xhigh` for Codex Max/5.2)
+- ✅ Context limits (272k context / 128k output for all Codex families)
+- ✅ Required options: `store: false`, `include: ["reasoning.encrypted_content"]`
+- ✅ Image input support for all models
+- ✅ All required metadata for OpenCode features
+
+### Modern Config Benefits (v1.0.210+)
+
+- **74% smaller**: 150 lines vs 572 lines
+- **DRY**: Common options defined once at provider level
+- **Variant cycling**: Built-in support for `Ctrl+T` to switch reasoning levels
+- **Easier maintenance**: Add new variants without copying model definitions
+
+## Usage
+
+1. **Check your OpenCode version**:
+   ```bash
+   opencode --version
+   ```
+
+2. **Copy the appropriate config** based on your version:
+   ```bash
+   # For v1.0.210+ (recommended):
+   cp config/opencode-modern.json ~/.config/opencode/opencode.jsonc
+
+   # For older versions:
+   cp config/opencode-legacy.json ~/.config/opencode/opencode.jsonc
+   ```
+
+3. **Run opencode**:
+   ```bash
+   # Modern config (v1.0.210+):
+   opencode run "task" --model=openai/gpt-5.2 --variant=medium
+   opencode run "task" --model=openai/gpt-5.2 --variant=high
+
+   # Legacy config:
+   opencode run "task" --model=openai/gpt-5.2-medium
+   opencode run "task" --model=openai/gpt-5.2-high
+   ```
+
+> **⚠️ Important**: Use the config file appropriate for your OpenCode version. Using the modern config with an older OpenCode version (v1.0.209 or below) will not work correctly.
+
+> **Note**: The config templates use an **unversioned** plugin entry (`opencode-openai-codex-auth`) so the installer can always pull the latest release. If you need reproducibility, pin a specific version manually.
+
+## Available Models
+
+Both configs provide access to the same model families:
+
+- **gpt-5.2** (none/low/medium/high/xhigh) - Latest GPT 5.2 model with full reasoning support
+- **gpt-5.2-codex** (low/medium/high/xhigh) - GPT 5.2 Codex presets
+- **gpt-5.1-codex-max** (low/medium/high/xhigh) - Codex Max presets
+- **gpt-5.1-codex** (low/medium/high) - Codex model presets
+- **gpt-5.1-codex-mini** (medium/high) - Codex mini tier presets
+- **gpt-5.1** (none/low/medium/high) - General-purpose reasoning presets
+
+All appear in the opencode model selector as "GPT 5.1 Codex Low (OAuth)", "GPT 5.1 High (OAuth)", etc.
+
+## Configuration Options
+
+See the main [README.md](../README.md#configuration) for detailed documentation of all configuration options.
+
+## Version History
+
+- **January 2026 (v1.0.210+)**: Introduced variant system support. Use `opencode-modern.json`
+- **December 2025 and earlier**: Use `opencode-legacy.json`

package/config/minimal-opencode.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-openai-codex-auth"],
+  "provider": {
+    "openai": {
+      "options": {
+        "store": false
+      }
+    }
+  },
+  "model": "openai/gpt-5-codex"
+}