opencode-openai-codex-multi-auth 4.4.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,89 @@
+![Image 1: opencode-openai-codex-auth](assets/readme-hero.svg)
+  
+  
+Fork maintained by [iam-brain](https://github.com/iam-brain).
+
+Upstream project (credit): [numman-ali/opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth)
+
+[![CI](https://github.com/iam-brain/opencode-openai-codex-multi-auth/actions/workflows/ci.yml/badge.svg)](https://github.com/iam-brain/opencode-openai-codex-multi-auth/actions)
+[![npm version](https://img.shields.io/npm/v/opencode-openai-codex-multi-auth.svg)](https://www.npmjs.com/package/opencode-openai-codex-multi-auth)
+
+**One install. Every Codex model. Multi-account aware.**
+[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-multi-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-multi-auth@latest --legacy
+opencode run "write hello world to test.txt" --model=openai/gpt-5.2-medium
+```
+Uninstall:
+```bash
+npx -y opencode-openai-codex-multi-auth@latest --uninstall
+npx -y opencode-openai-codex-multi-auth@latest --uninstall --all
+```
+
+Note: if you previously installed the GitHub-spec version (`github:iam-brain/opencode-openai-codex-multi-auth`), re-running the installer will migrate you to the npm package.
+---
+## 📦 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
+- Multi-account support with sticky selection + PID offset (great for parallel agents)
+- Optional round-robin account rotation (maximum throughput)
+- OpenCode TUI toasts + `openai-accounts` / `openai-accounts-switch` tools
+---
+## 📚 Docs
+- Getting Started: `docs/getting-started.md`
+- Configuration: `docs/configuration.md`
+- Multi-Account: `docs/multi-account.md`
+- Troubleshooting: `docs/troubleshooting.md`
+- Architecture: `docs/development/ARCHITECTURE.md`
+---
+## ⚠️ 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.
+
+## Credits
+
+- Original implementation and ongoing upstream work: Numman Ali and contributors (`numman-ali/opencode-openai-codex-auth`)
+- This fork: multi-account pool, sticky-by-default rotation with PID offset, round-robin option, and account tools/toasts
+
+**Built for developers who value simplicity.**

package/assets/openai-codex-auth-config.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/iam-brain/opencode-openai-codex-multi-auth/main/assets/openai-codex-auth-config.schema.json",
+  "title": "OpenCode OpenAI Codex Auth Plugin Config",
+  "type": "object",
+  "additionalProperties": true,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON schema reference for editor autocompletion"
+    },
+    "codexMode": {
+      "type": "boolean",
+      "default": true,
+      "description": "Enable CODEX_MODE (Codex/OpenCode bridge prompt)."
+    },
+    "accountSelectionStrategy": {
+      "type": "string",
+      "enum": ["sticky", "round-robin"],
+      "default": "sticky",
+      "description": "How to select accounts when 2+ accounts are configured."
+    },
+    "pidOffsetEnabled": {
+      "type": "boolean",
+      "default": true,
+      "description": "Offset starting account by process PID (helps parallel agents spread across accounts)."
+    },
+    "quietMode": {
+      "type": "boolean",
+      "default": false,
+      "description": "Suppress most toast notifications."
+    },
+    "tokenRefreshSkewMs": {
+      "type": "number",
+      "minimum": 0,
+      "default": 60000,
+      "description": "Milliseconds before token expiry to refresh proactively."
+    },
+    "rateLimitToastDebounceMs": {
+      "type": "number",
+      "minimum": 0,
+      "default": 60000,
+      "description": "Debounce interval for account-related toasts."
+    },
+    "retryAllAccountsRateLimited": {
+      "type": "boolean",
+      "default": false,
+      "description": "When all accounts are rate limited, wait and retry automatically."
+    },
+    "retryAllAccountsMaxWaitMs": {
+      "type": "number",
+      "minimum": 0,
+      "default": 30000,
+      "description": "Maximum wait time (ms) when all accounts are rate limited. 0 = no limit."
+    },
+    "retryAllAccountsMaxRetries": {
+      "type": "number",
+      "minimum": 0,
+      "default": 1,
+      "description": "Maximum number of all-accounts wait cycles."
+    }
+  }
+}

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-multi-auth"],
+  "provider": {
+    "openai": {
+      "options": {
+        "store": false
+      }
+    }
+  },
+  "model": "openai/gpt-5-codex"
+}