oc-codex-multi-auth 6.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Numman Ali
+
+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 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,162 @@
+# oc-codex-multi-auth
+
+[![npm version](https://img.shields.io/npm/v/oc-codex-multi-auth.svg)](https://www.npmjs.com/package/oc-codex-multi-auth)
+[![npm downloads](https://img.shields.io/npm/dw/oc-codex-multi-auth.svg)](https://www.npmjs.com/package/oc-codex-multi-auth)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+Use your ChatGPT Plus/Pro subscription inside OpenCode with OAuth login, GPT-5/Codex model presets, and multi-account failover.
+
+`oc-codex-multi-auth` is an OpenCode plugin for developers who want Codex-first GPT-5 workflows in OpenCode without switching to separate Platform API credentials for personal use. It uses the same official OAuth flow as the Codex CLI, adds model templates for current GPT-5 families, and can rotate across multiple ChatGPT accounts when one account is rate-limited or unavailable.
+
+## What This Project Does
+
+- Adds an OpenCode plugin that authenticates with ChatGPT Plus/Pro through official OAuth
+- Ships ready-to-use model templates for `gpt-5.4`, `gpt-5-codex`, and related GPT-5 families
+- Routes requests through a stateless Codex-compatible request pipeline with automatic token refresh
+- Supports multi-account rotation, per-project account storage, and guided onboarding commands
+
+## Quick Start
+
+```bash
+# 1. Install or refresh the plugin config
+npx -y oc-codex-multi-auth@latest
+
+# 2. Sign in with ChatGPT Plus/Pro
+opencode auth login
+
+# 3. Run a prompt in OpenCode
+opencode run "Explain this repository" --model=openai/gpt-5.4 --variant=medium
+```
+
+What the installer does:
+
+- writes `~/.config/opencode/opencode.json`
+- backs up an existing config before changing it
+- normalizes the plugin entry to `"oc-codex-multi-auth"`
+- clears the cached plugin copy so OpenCode reinstalls the latest package
+
+By default, the installer now writes a full catalog config that includes both:
+- modern base model entries such as `gpt-5.4` for `--variant` workflows
+- explicit preset entries such as `gpt-5.4-high` so the shipped catalog is visible directly in model pickers
+
+## Example Usage
+
+```bash
+# General GPT-5 workflow
+opencode run "Summarize the failing test and suggest a fix" --model=openai/gpt-5.4 --variant=medium
+
+# Codex-focused workflow
+opencode run "Refactor the retry logic and update the tests" --model=openai/gpt-5-codex --variant=high
+```
+
+## Usage Notice
+
+> [!CAUTION]
+> This project is for personal development use with your own ChatGPT Plus/Pro subscription.
+>
+> - It is not intended for commercial resale, shared multi-user access, or production services.
+> - It uses official OAuth authentication, but it is an independent open-source project and is not affiliated with OpenAI.
+> - For production applications, use the [OpenAI Platform API](https://platform.openai.com/).
+> - You are responsible for complying with [OpenAI's Terms of Use](https://openai.com/policies/terms-of-use/).
+
+## Why This Exists
+
+OpenCode users often want the same GPT-5 and Codex model experience they use in ChatGPT, but inside a local terminal workflow. This plugin exists to bridge that gap cleanly:
+
+- official OAuth instead of scraped cookies or unofficial auth flows
+- OpenCode-ready model definitions instead of hand-rolled config every time
+- account rotation and recovery features for people who work across multiple ChatGPT accounts or workspaces
+
+## Features
+
+- Official OAuth login flow compatible with ChatGPT Plus/Pro access
+- GPT-5 and Codex model templates for modern and legacy OpenCode versions
+- Multi-account rotation with health-aware failover
+- Per-project account storage support
+- Beginner-focused commands such as `codex-setup`, `codex-help`, `codex-doctor`, and `codex-next`
+- Interactive account switching, labeling, tagging, and backup/import commands
+- Stateless request handling with `reasoning.encrypted_content` for multi-turn sessions
+- Request logging and troubleshooting hooks for debugging OpenCode integration issues
+
+## Common Workflows
+
+- Personal coding sessions in OpenCode using `gpt-5.4` or `gpt-5-codex`
+- Switching between personal and workspace-linked ChatGPT accounts
+- Keeping separate account pools per project or monorepo
+- Recovering from unsupported-model, auth, or rate-limit issues with guided commands
+
+## How It Works
+
+The plugin sits between OpenCode and the ChatGPT-backed Codex workflow:
+
+1. OpenCode loads the plugin and sends model requests through the plugin fetch pipeline.
+2. The plugin authenticates with ChatGPT OAuth and refreshes tokens when needed.
+3. Requests are normalized for the Codex backend and sent with `store: false`.
+4. The plugin chooses the best account/workspace candidate, retries intelligently, and preserves conversation continuity through encrypted reasoning state.
+
+See [Architecture](docs/development/ARCHITECTURE.md) for implementation details.
+
+## Installation
+
+Use the quick-start path above for the fastest setup. For full setup, local development installs, legacy OpenCode support, and verification steps, see [Getting Started](docs/getting-started.md).
+
+If you prefer the compact variant-only config on OpenCode `v1.0.210+`, use:
+
+```bash
+npx -y oc-codex-multi-auth@latest --modern
+```
+
+## Configuration
+
+Detailed configuration lives outside this README:
+
+- [Getting Started](docs/getting-started.md) for install and first-run setup
+- [Configuration Reference](docs/configuration.md) for config keys, env vars, and fallback behavior
+- [Config Templates](config/README.md) for modern vs legacy OpenCode examples
+
+## Troubleshooting
+
+Start here if the plugin does not load or authenticate correctly:
+
+- [Troubleshooting](docs/troubleshooting.md)
+- [Privacy & Data Handling](docs/privacy.md)
+- [FAQ](docs/faq.md)
+- [Security Policy](SECURITY.md)
+
+Common first checks:
+
+- confirm `"plugin": ["oc-codex-multi-auth"]` is present in your OpenCode config
+
+## 6.0.0 Cutover
+
+This release intentionally breaks the old package line and moves the runtime to package-aligned storage names.
+
+- Rename the GitHub repository to `ndycode/oc-codex-multi-auth`
+- Publish `oc-codex-multi-auth@6.0.0`
+- Deprecate `oc-chatgpt-multi-auth` on npm with a pointer to the new package
+- Verify docs, badges, repo links, and OpenCode config examples all resolve to `oc-codex-multi-auth`
+- rerun `opencode auth login`
+- inspect `~/.opencode/logs/codex-plugin/` after running one request with `ENABLE_PLUGIN_REQUEST_LOGGING=1`
+
+## FAQ
+
+Short answers for the most common questions live in [docs/faq.md](docs/faq.md), including:
+
+- who this plugin is for
+- which OpenCode versions it supports
+- how the modern and legacy config templates differ
+- when to use this plugin versus the OpenAI Platform API
+
+## Contributing
+
+Contributions are welcome if they keep the project accurate, maintainable, and aligned with its personal-use scope.
+
+- [Contributing Guide](CONTRIBUTING.md)
+- [Code of Conduct](CODE_OF_CONDUCT.md)
+- [Security Policy](SECURITY.md)
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+ChatGPT, GPT-5, Codex, and OpenAI are trademarks of OpenAI, L.L.C.

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="oc-codex-multi-auth">
+  <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">
+    oc-codex-multi-auth
+  </text>
+  <text x="420" y="170" fill="#cbd5f5" font-size="24" font-family="'IBM Plex Sans','Segoe UI',Arial,sans-serif">
+    Codex-first ChatGPT Plus/Pro auth for OpenCode
+  </text>
+  <text x="420" y="220" fill="#7dd3fc" font-size="18" font-family="'IBM Plex Sans','Segoe UI',Arial,sans-serif">
+    One-command install, account migration, modern variants
+  </text>
+</svg>

package/config/README.md

@@ -0,0 +1,96 @@
+# Configuration
+
+This directory contains the official OpenCode config templates for `oc-codex-multi-auth`.
+
+## Required: choose the right config file
+
+| File | OpenCode version | Description |
+|------|------------------|-------------|
+| [`opencode-modern.json`](./opencode-modern.json) | **v1.0.210+** | Variant-based config: 9 base models with 34 total presets |
+| [`opencode-legacy.json`](./opencode-legacy.json) | **v1.0.209 and below** | Legacy explicit entries: 34 individual model definitions |
+
+The installer currently uses a merged full-catalog mode by default so users get both the modern base entries and the explicit preset entries without having to hand-edit `opencode.json`.
+
+## Quick pick
+
+If your OpenCode version is v1.0.210 or newer:
+
+```bash
+cp config/opencode-modern.json ~/.config/opencode/opencode.json
+```
+
+If your OpenCode version is v1.0.209 or older:
+
+```bash
+cp config/opencode-legacy.json ~/.config/opencode/opencode.json
+```
+
+Check your version with:
+
+```bash
+opencode --version
+```
+
+## Why there are two templates
+
+OpenCode v1.0.210+ added model `variants`, so one model entry can expose multiple reasoning levels. That keeps modern config much smaller while preserving the same effective presets.
+
+Both templates include:
+- GPT-5.4, GPT-5.4 Pro, GPT-5.4 Mini, GPT-5.4 Nano, GPT-5 Codex, GPT-5.1, GPT-5.1 Codex, GPT-5.1 Codex Max, GPT-5.1 Codex Mini
+- Reasoning variants per model family
+- `store: false` and `include: ["reasoning.encrypted_content"]`
+- Context metadata (`gpt-5.4`/`gpt-5.4-pro`: 1,050,000; `gpt-5.4-mini`/`gpt-5.4-nano`/Codex models: 400,000; `gpt-5.1`: 272,000; all output: 128,000)
+
+Use `opencode debug config` to verify that these template entries were merged into your effective config. `opencode models openai` currently shows OpenCode's built-in provider catalog and can omit config-defined entries such as `gpt-5.4-mini`.
+
+If your OpenCode runtime supports global compaction tuning, you can also set:
+- `model_context_window = 1050000`
+- `model_auto_compact_token_limit = 950000`
+
+## Spark model note
+
+The templates intentionally do **not** include `gpt-5.3-codex-spark` by default. Spark is often entitlement-gated at the account/workspace level, so shipping it by default causes avoidable startup failures for many users.
+
+If your workspace is entitled, you can add Spark model IDs manually.
+
+## Usage examples
+
+Modern template (v1.0.210+):
+
+```bash
+opencode run "task" --model=openai/gpt-5.4 --variant=medium
+opencode run "task" --model=openai/gpt-5-codex --variant=high
+```
+
+Legacy template (v1.0.209 and below):
+
+```bash
+opencode run "task" --model=openai/gpt-5.4-medium
+opencode run "task" --model=openai/gpt-5-codex-high
+```
+
+## Minimal config (advanced)
+
+A barebones debug template is available at [`minimal-opencode.json`](./minimal-opencode.json). It omits the full preset catalog.
+
+## Unsupported-model behavior
+
+Current defaults are strict entitlement handling:
+- `unsupportedCodexPolicy: "strict"` returns entitlement errors directly
+- set `unsupportedCodexPolicy: "fallback"` (or `CODEX_AUTH_UNSUPPORTED_MODEL_POLICY=fallback`) to enable automatic fallback retries
+- `fallbackToGpt52OnUnsupportedGpt53: true` keeps the legacy `gpt-5.3-codex -> gpt-5.2-codex` edge inside fallback mode
+- `gpt-5.4-pro -> gpt-5.4` is included by default in fallback mode (relevant only if you add `gpt-5.4-pro` manually)
+- `unsupportedCodexFallbackChain` lets you override fallback order per model
+
+Default fallback chain (when policy is `fallback`):
+- `gpt-5.4-pro -> gpt-5.4` (if you manually select `gpt-5.4-pro`)
+- `gpt-5.3-codex -> gpt-5-codex -> gpt-5.2-codex`
+- `gpt-5.3-codex-spark -> gpt-5-codex -> gpt-5.3-codex -> gpt-5.2-codex` (only relevant if Spark IDs are added manually)
+- `gpt-5.2-codex -> gpt-5-codex`
+- `gpt-5.1-codex -> gpt-5-codex`
+
+## Additional docs
+
+- Main config reference: [`docs/configuration.md`](../docs/configuration.md)
+- Getting started: [`docs/getting-started.md`](../docs/getting-started.md)
+- Troubleshooting: [`docs/troubleshooting.md`](../docs/troubleshooting.md)

package/config/minimal-opencode.json

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