feat: integrate codex-multi-auth sync flow

README.md

@@ -11,7 +11,7 @@ OAuth plugin for OpenCode that lets you use ChatGPT Plus/Pro rate limits with mo
 ## What You Get
 
 - **GPT-5.4, GPT-5 Codex, GPT-5.1 Codex Max** and all GPT-5.x variants via ChatGPT OAuth
-- **Multi-account support** — Add up to 20 ChatGPT accounts, health-aware rotation with automatic failover
+- **Multi-account support** — Add as many ChatGPT accounts as you need, health-aware rotation with automatic failover
 - **Per-project accounts** — Each project gets its own account storage (new in v4.10.0)
 - **Workspace-aware identity persistence** — Keeps workspace/org identity stable across token refresh and verify-flagged restore flows
 - **Click-to-switch** — Switch accounts directly from the OpenCode TUI
@@ -68,6 +68,8 @@ npx -y oc-chatgpt-multi-auth@latest
 
 This writes the config to `~/.config/opencode/opencode.json`, backs up existing config, and clears the plugin cache.
 
+After install, run `codex-doctor` once to confirm your local auth and account health are ready.
+
 > Want legacy config (OpenCode v1.0.209 and below)? Add `--legacy` flag.
 
 **Option C: Manual setup**
@@ -275,7 +277,7 @@ For legacy OpenCode (v1.0.209 and below), use `config/opencode-legacy.json` whic
 
 ## Multi-Account Setup
 
-Add multiple ChatGPT accounts for higher combined quotas. The plugin uses **health-aware rotation** with automatic failover and supports up to 20 accounts.
+Add multiple ChatGPT accounts for higher combined quotas. The plugin uses **health-aware rotation** with automatic failover and supports unlimited accounts.
 
 ```bash
 opencode auth login  # Run again to add more accounts
@@ -836,6 +838,30 @@ Create `~/.opencode/openai-codex-auth-config.json` for optional settings:
 | `toastDurationMs` | `5000` | How long toast notifications stay visible (ms) |
 | `beginnerSafeMode` | `false` | Beginner-safe retry profile: conservative retry budget, disables all-accounts wait/retry, and caps all-accounts retries |
 
+### Experimental Settings
+
+The auth dashboard now includes `Experimental settings` with a manual sync option for `codex-multi-auth`.
+
+Persist the toggle in `~/.opencode/openai-codex-auth-config.json`:
+
+```json
+{
+  "experimental": {
+    "syncFromCodexMultiAuth": {
+      "enabled": true
+    }
+  }
+}
+```
+
+When enabled, `Sync now` will auto-discover a `codex-multi-auth` account store from:
+- `CODEX_MULTI_AUTH_DIR`
+- `CODEX_HOME/multi-auth`
+- `~/DevTools/config/codex/multi-auth`
+- `~/.codex/multi-auth`
+
+It previews import impact first and skips duplicate overlaps using the existing dedupe-aware import flow.
+
 ### Retry Behavior
 
 | Option | Default | What It Does |

docs/configuration.md

@@ -168,6 +168,26 @@ The sample above intentionally sets `"retryAllAccountsMaxRetries": 3` as a bound
 | `fetchTimeoutMs` | `60000` | upstream fetch timeout in ms |
 | `streamStallTimeoutMs` | `45000` | max time to wait for next SSE chunk before aborting |
 
+### Experimental Settings
+
+Enable manual sync from `codex-multi-auth`:
+
+```json
+{
+  "experimental": {
+    "syncFromCodexMultiAuth": {
+      "enabled": true
+    }
+  }
+}
+```
+
+When enabled, the auth dashboard can discover `codex-multi-auth` storage from:
+- `CODEX_MULTI_AUTH_DIR`
+- `CODEX_HOME/multi-auth`
+- `~/DevTools/config/codex/multi-auth`
+- `~/.codex/multi-auth`
+
 ### beginner safe mode behavior
 
 when `beginnerSafeMode` is enabled (`true` or `CODEX_AUTH_BEGINNER_SAFE_MODE=1`), the plugin applies a safer retry profile automatically: