codex-multi-auth 0.1.0

package/LICENSE

@@ -0,0 +1 @@
+

package/README.md

@@ -0,0 +1,162 @@
+# codex-multi-auth
+
+[![npm version](https://img.shields.io/npm/v/codex-multi-auth.svg)](https://www.npmjs.com/package/codex-multi-auth)
+[![npm downloads](https://img.shields.io/npm/dw/codex-multi-auth.svg)](https://www.npmjs.com/package/codex-multi-auth)
+
+Codex CLI-first multi-account OAuth manager for the official Codex CLI.
+
+* * *
+
+## Quick Start
+
+Install from source (current project workflow):
+
+```bash
+npm install -g @openai/codex
+git clone https://github.com/ndycode/codex-multi-auth.git
+cd codex-multi-auth
+npm install
+npm run build
+npm link
+```
+
+Add and verify accounts:
+
+```bash
+codex auth login
+codex auth list
+codex auth check
+```
+
+If browser opens during `codex auth login`, that is expected. Complete OAuth and return to the same terminal.
+
+* * *
+
+## What You Get
+
+- `codex auth ...` commands for multi-account management.
+- Interactive beginner-friendly dashboard with hotkeys.
+- Health checks, forecasting, safe auto-fix, and diagnostics.
+- Live account sync and Codex CLI active-account state sync.
+
+* * *
+
+## Most-Used Commands
+
+| Command | Use it for |
+| --- | --- |
+| `codex auth login` | Add/manage accounts in the dashboard |
+| `codex auth list` | See saved accounts and current account |
+| `codex auth switch <index>` | Switch current account |
+| `codex auth check` | Quick health + live session checks |
+| `codex auth forecast --live` | Choose the best next account |
+| `codex auth fix --dry-run` | Preview safe fixes |
+| `codex auth fix` | Apply safe fixes |
+| `codex auth doctor --fix` | Diagnose and auto-repair common issues |
+| `codex auth report --live --json` | Full machine-readable report |
+| `codex auth features` | Print all implemented feature areas |
+
+Complete command reference: [docs/reference/commands.md](docs/reference/commands.md)
+
+* * *
+
+## Dashboard Hotkeys
+
+Main dashboard:
+
+- `Up` / `Down`: move
+- `Enter`: select
+- `1-9`: quick switch account
+- `/`: search
+- `?` or `H`: help
+- `Q`: back
+
+Account detail menu:
+
+- `S`: set current
+- `R`: refresh login
+- `E`: enable/disable
+- `D`: delete account
+
+* * *
+
+## Settings and Advanced Backend
+
+Open:
+
+```bash
+codex auth login
+# Settings
+```
+
+Settings are persisted in:
+
+- `~/.codex/multi-auth/settings.json`
+- or `CODEX_MULTI_AUTH_DIR/settings.json` when custom root is set
+
+Reference:
+
+- [docs/reference/settings.md](docs/reference/settings.md)
+
+* * *
+
+## Documentation Map
+
+Start here:
+
+- Docs portal: [docs/README.md](docs/README.md)
+- Beginner setup: [docs/getting-started.md](docs/getting-started.md)
+- Full feature matrix: [docs/features.md](docs/features.md)
+- Configuration: [docs/configuration.md](docs/configuration.md)
+- Troubleshooting: [docs/troubleshooting.md](docs/troubleshooting.md)
+- Storage/path reference: [docs/reference/storage-paths.md](docs/reference/storage-paths.md)
+- Upgrade guide: [docs/upgrade.md](docs/upgrade.md)
+- Privacy/data handling: [docs/privacy.md](docs/privacy.md)
+
+Maintainer docs:
+
+- Architecture: [docs/development/ARCHITECTURE.md](docs/development/ARCHITECTURE.md)
+- Config fields: [docs/development/CONFIG_FIELDS.md](docs/development/CONFIG_FIELDS.md)
+- Config flow: [docs/development/CONFIG_FLOW.md](docs/development/CONFIG_FLOW.md)
+- Testing: [docs/development/TESTING.md](docs/development/TESTING.md)
+- TUI parity checklist: [docs/development/TUI_PARITY_CHECKLIST.md](docs/development/TUI_PARITY_CHECKLIST.md)
+
+* * *
+
+## Quick Troubleshooting
+
+```bash
+codex auth doctor --fix
+codex auth list
+codex auth forecast --live
+```
+
+If command routing is broken:
+
+```bash
+where codex
+codex --version
+codex auth status
+codex multi auth status
+```
+
+* * *
+
+## Development
+
+```bash
+npm run typecheck
+npm run lint
+npm test
+npm run build
+```
+
+* * *
+
+## Security and Usage Notice
+
+This project is for personal development workflows. You are responsible for compliance with OpenAI policies.
+
+- Security policy: [SECURITY.md](SECURITY.md)
+- License: [LICENSE](LICENSE)
+

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,87 @@
+# Configuration
+
+This directory contains the official OpenCode config templates for the ChatGPT Codex OAuth plugin.
+
+## Required: choose the right config file
+
+| File | OpenCode version | Description |
+|------|------------------|-------------|
+| [`opencode-modern.json`](./opencode-modern.json) | **v1.0.210+** | Variant-based config: 6 base models with 27 total presets |
+| [`opencode-legacy.json`](./opencode-legacy.json) | **v1.0.209 and below** | Legacy explicit entries: 22 individual model definitions |
+
+## 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.2, 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 (272k context / 128k output)
+
+## 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.2 --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.2-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
+- `unsupportedCodexFallbackChain` lets you override fallback order per model
+- Spark entitlement failures (`gpt-5.3-codex-spark`) force fallback immediately, even with strict policy, to support non-entitled workspaces
+
+Default fallback chain (when policy is `fallback`):
+- `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": ["codex-multi-auth"],
+
+  "provider": {
+    "openai": {
+      "options": {
+        "store": false
+      }
+    }
+  },
+  "model": "openai/gpt-5-codex"
+}