Merge pull request #93 from ndycode/feat/device-code-auth

add ChatGPT device-code login flow

Author: ndycode

docs/getting-started.md

@@ -76,8 +76,9 @@ The browser-based OAuth flow uses the same local callback port as Codex CLI: `ht
 If you are on SSH, WSL, or another environment where the browser callback flow is inconvenient:
 
 1. rerun `opencode auth login`
-2. choose `ChatGPT Plus/Pro (Manual URL Paste)`
-3. paste the full redirect URL after login completes in the browser
+2. choose `ChatGPT Plus/Pro MULTI (Device Code)`
+3. open the verification link, enter the one-time code, and wait for login to finish
+4. if device code is unavailable on your auth server, fall back to `ChatGPT Plus/Pro MULTI (Manual URL Paste)`
 
 ## Add the Plugin to OpenCode
 

docs/troubleshooting.md

@@ -182,8 +182,9 @@ Failed to access Codex API
 
 1. **Manual URL paste:**
    - Re-run `opencode auth login`
-   - Select **"ChatGPT Plus/Pro (Manual URL Paste)"**
-   - Paste the full redirect URL after login
+   - Select **"ChatGPT Plus/Pro MULTI (Device Code)"** first if you are on SSH, WSL, or a headless machine
+   - If device code is unavailable, fall back to **"ChatGPT Plus/Pro MULTI (Manual URL Paste)"**
+   - Paste the full redirect URL after login when using the manual flow
 
 2. **Check port 1455 availability:**
    ```bash
@@ -207,7 +208,7 @@ Failed to access Codex API
 **Solutions:**
 - Re-run `opencode auth login` to generate a fresh URL
 - Open the URL directly in browser (don't use a stale link)
-- For SSH/WSL/remote, use **"Manual URL Paste"** option
+- For SSH/WSL/remote, use **"Device Code"** first, then **"Manual URL Paste"** if needed
 
 </details>
 
@@ -617,7 +618,7 @@ ssh -L 1455:localhost:1455 user@remote
 
 **Docker / Containers:**
 - OAuth with localhost redirect doesn't work in containers
-- Use SSH port forwarding or manual URL flow
+- Use Device Code first, then SSH port forwarding or manual URL flow if needed
 
 </details>