From 9cef9d114251ed79f5dbbe29c9018de969adbbf8 Mon Sep 17 00:00:00 2001
From: YeonGyu-Kim <code.yeon.gyu@gmail.com>
Date: Wed, 17 Dec 2025 09:45:23 +0900
Subject: [PATCH] Add opencode-antigravity-auth plugin guide and
 oh-my-opencode.json model override documentation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Added opencode-antigravity-auth plugin setup guide to Installation section
- Added oh-my-opencode.json agent model override configuration with google_auth: false
- Added available Antigravity model names reference list
- Updated Configuration > Google Auth section with plugin recommendation
- Documented multi-account load balancing feature
- Applied documentation updates to EN, KO, JA READMEs

🤖 Generated with assistance of OhMyOpenCode (https://github.com/code-yeongyu/oh-my-opencode)
---
 README.ja.md | 54 +++++++++++++++++++++++++++++++++++++++------
 README.ko.md | 54 +++++++++++++++++++++++++++++++++++++++------
 README.md    | 62 ++++++++++++++++++++++++++++++++++++++++++++++------
 3 files changed, 149 insertions(+), 21 deletions(-)

diff --git a/README.ja.md b/README.ja.md
index e54cfe6..d598c4b 100644
--- a/README.ja.md
+++ b/README.ja.md
@@ -223,25 +223,52 @@ opencode auth login
 
 #### 4.2 Google Gemini (Antigravity OAuth)
 
-まず、`~/.config/opencode/oh-my-opencode.json` で Google auth を有効にします：
+まず、opencode-antigravity-auth プラグインを追加します：
 
 ```json
 {
-  "google_auth": true
+  "plugin": [
+    "oh-my-opencode",
+    "opencode-antigravity-auth@1.1.2"
+  ]
 }
 ```
 
+#### 4.2.1 モデル設定
+
+`opencode.json` に完全なモデル設定も構成する必要があります。
+[opencode-antigravity-auth ドキュメント](https://github.com/NoeFabris/opencode-antigravity-auth)を読み、README から provider/models 設定をコピーして、ユーザーの既存のセットアップを壊さないよう慎重にマージしてください。
+
+#### 4.2.2 oh-my-opencode エージェントモデルのオーバーライド
+
+`opencode-antigravity-auth` プラグインは内蔵 Google auth と異なるモデル名を使用します。`oh-my-opencode.json`（または `.opencode/oh-my-opencode.json`）でエージェントモデルをオーバーライドし、内蔵 `google_auth` を無効化してください：
+
+```json
+{
+  "google_auth": false,
+  "agents": {
+    "frontend-ui-ux-engineer": { "model": "google/gemini-3-pro-high" },
+    "document-writer": { "model": "google/gemini-3-pro-high" },
+    "multimodal-looker": { "model": "google/gemini-2.5-flash" }
+  }
+}
+```
+
+**利用可能なモデル名**: `google/gemini-3-pro-high`, `google/gemini-3-pro-medium`, `google/gemini-3-pro-low`, `google/gemini-2.5-flash`, `google/gemini-2.5-flash-lite`, `google/claude-sonnet-4-5`, `google/claude-sonnet-4-5-thinking`, `google/claude-opus-4-5-thinking`, `google/gpt-oss-120b-medium`
+
 その後、認証を行います：
 
 ```bash
 opencode auth login
 # Provider: Google を選択
 # Login method: OAuth with Google (Antigravity) を選択
-# ユーザーにブラウザでの OAuth フロー完了を案内
-# 完了まで待機
+# ブラウザでサインイン完了（自動検出）
+# オプション：マルチアカウントロードバランシング用に追加の Google アカウントを登録
 # 成功を確認し、ユーザーに報告
 ```
 
+**マルチアカウントロードバランシング**: プラグインは最大10個の Google アカウントをサポートします。1つのアカウントがレートリミットに達すると、自動的に次のアカウントに切り替わります。
+
 #### 4.3 OpenAI (ChatGPT Plus/Pro)
 
 まず、opencode-openai-codex-auth プラグインを追加します：
@@ -559,7 +586,22 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
 
 ### Google Auth
 
-Google Gemini モデルのための内蔵 Antigravity OAuth を有効化します：
+**推奨**: 外部の [`opencode-antigravity-auth`](https://github.com/NoeFabris/opencode-antigravity-auth) プラグインを使用してください。マルチアカウントロードバランシング、より多くのモデル（Antigravity 経由の Claude を含む）、活発なメンテナンスを提供します。[インストール > Google Gemini](#42-google-gemini-antigravity-oauth) を参照。
+
+`opencode-antigravity-auth` 使用時は内蔵 auth を無効化し、`oh-my-opencode.json` でエージェントモデルをオーバーライドしてください：
+
+```json
+{
+  "google_auth": false,
+  "agents": {
+    "frontend-ui-ux-engineer": { "model": "google/gemini-3-pro-high" },
+    "document-writer": { "model": "google/gemini-3-pro-high" },
+    "multimodal-looker": { "model": "google/gemini-2.5-flash" }
+  }
+}
+```
+
+**代替案**: 内蔵 Antigravity OAuth を有効化（単一アカウント、Gemini モデルのみ）：
 
 ```json
 {
@@ -567,8 +609,6 @@ Google Gemini モデルのための内蔵 Antigravity OAuth を有効化しま
 }
 ```
 
-有効化すると、`opencode auth login` 実行時に Google プロバイダーで "OAuth with Google (Antigravity)" ログインオプションが表示されます。
-
 ### Agents
 
 内蔵エージェント設定をオーバーライドできます：
diff --git a/README.ko.md b/README.ko.md
index 6f9f984..1410d05 100644
--- a/README.ko.md
+++ b/README.ko.md
@@ -220,25 +220,52 @@ opencode auth login
 
 #### 4.2 Google Gemini (Antigravity OAuth)
 
-먼저 `~/.config/opencode/oh-my-opencode.json` 에서 Google auth를 활성화하세요:
+먼저 opencode-antigravity-auth 플러그인 추가:
 
 ```json
 {
-  "google_auth": true
+  "plugin": [
+    "oh-my-opencode",
+    "opencode-antigravity-auth@1.1.2"
+  ]
 }
 ```
 
+#### 4.2.1 모델 설정
+
+`opencode.json`에 전체 모델 설정도 구성해야 합니다.
+[opencode-antigravity-auth 문서](https://github.com/NoeFabris/opencode-antigravity-auth)를 읽고, README에서 provider/models 설정을 복사하여, 사용자의 기존 셋업에 영향을 주지 않도록 신중하게 통합하세요.
+
+#### 4.2.2 oh-my-opencode 에이전트 모델 오버라이드
+
+`opencode-antigravity-auth` 플러그인은 내장 Google auth와 다른 모델 이름을 사용합니다. `oh-my-opencode.json` (또는 `.opencode/oh-my-opencode.json`)에서 에이전트 모델을 오버라이드하고, 내장 `google_auth`를 비활성화하세요:
+
+```json
+{
+  "google_auth": false,
+  "agents": {
+    "frontend-ui-ux-engineer": { "model": "google/gemini-3-pro-high" },
+    "document-writer": { "model": "google/gemini-3-pro-high" },
+    "multimodal-looker": { "model": "google/gemini-2.5-flash" }
+  }
+}
+```
+
+**사용 가능한 모델 이름**: `google/gemini-3-pro-high`, `google/gemini-3-pro-medium`, `google/gemini-3-pro-low`, `google/gemini-2.5-flash`, `google/gemini-2.5-flash-lite`, `google/claude-sonnet-4-5`, `google/claude-sonnet-4-5-thinking`, `google/claude-opus-4-5-thinking`, `google/gpt-oss-120b-medium`
+
 그 후 인증:
 
 ```bash
 opencode auth login
 # Provider: Google 선택
 # Login method: OAuth with Google (Antigravity) 선택
-# 사용자에게 브라우저에서 OAuth 플로우를 완료하도록 안내
-# 최종 완료까지 대기
+# 브라우저에서 로그인 완료 (자동 감지)
+# 선택사항: 멀티 계정 로드밸런싱을 위해 추가 Google 계정 등록
 # 진짜 완료되었음을 검증하고 사용자에게 안내
 ```
 
+**멀티 계정 로드밸런싱**: 플러그인은 최대 10개의 Google 계정을 지원합니다. 한 계정이 레이트 리밋에 걸리면 자동으로 다음 계정으로 전환됩니다.
+
 #### 4.3 OpenAI (ChatGPT Plus/Pro)
 
 먼저 opencode-openai-codex-auth 플러그인 추가:
@@ -553,7 +580,22 @@ Schema 자동 완성이 지원됩니다:
 
 ### Google Auth
 
-Google Gemini 모델을 위한 내장 Antigravity OAuth를 활성화합니다:
+**권장**: 외부 [`opencode-antigravity-auth`](https://github.com/NoeFabris/opencode-antigravity-auth) 플러그인을 사용하세요. 멀티 계정 로드밸런싱, 더 많은 모델(Antigravity를 통한 Claude 포함), 활발한 유지보수를 제공합니다. [설치 > Google Gemini](#42-google-gemini-antigravity-oauth) 참조.
+
+`opencode-antigravity-auth` 사용 시 내장 auth를 비활성화하고 `oh-my-opencode.json`에서 에이전트 모델을 오버라이드하세요:
+
+```json
+{
+  "google_auth": false,
+  "agents": {
+    "frontend-ui-ux-engineer": { "model": "google/gemini-3-pro-high" },
+    "document-writer": { "model": "google/gemini-3-pro-high" },
+    "multimodal-looker": { "model": "google/gemini-2.5-flash" }
+  }
+}
+```
+
+**대안**: 내장 Antigravity OAuth 활성화 (단일 계정, Gemini 모델만):
 
 ```json
 {
@@ -561,8 +603,6 @@ Google Gemini 모델을 위한 내장 Antigravity OAuth를 활성화합니다:
 }
 ```
 
-활성화하면 `opencode auth login` 실행 시 Google 프로바이더에서 "OAuth with Google (Antigravity)" 로그인 옵션이 표시됩니다.
-
 ### Agents
 
 내장 에이전트 설정을 오버라이드할 수 있습니다:
diff --git a/README.md b/README.md
index 8be025d..e3c08ca 100644
--- a/README.md
+++ b/README.md
@@ -249,17 +249,52 @@ opencode auth login
 
 #### Google Gemini (Antigravity OAuth)
 
+First, add the opencode-antigravity-auth plugin:
+
+```json
+{
+  "plugin": [
+    "oh-my-opencode",
+    "opencode-antigravity-auth@1.1.2"
+  ]
+}
+```
+
+##### Model Configuration
+
+You'll also need full model settings in `opencode.json`.
+Read the [opencode-antigravity-auth documentation](https://github.com/NoeFabris/opencode-antigravity-auth), copy provider/models config from the README, and merge carefully to avoid breaking the user's existing setup.
+
+##### oh-my-opencode Agent Model Override
+
+The `opencode-antigravity-auth` plugin uses different model names than the built-in Google auth. Override the agent models in `oh-my-opencode.json` (or `.opencode/oh-my-opencode.json`) and disable the built-in `google_auth`:
+
+```json
+{
+  "google_auth": false,
+  "agents": {
+    "frontend-ui-ux-engineer": { "model": "google/gemini-3-pro-high" },
+    "document-writer": { "model": "google/gemini-3-pro-high" },
+    "multimodal-looker": { "model": "google/gemini-2.5-flash" }
+  }
+}
+```
+
+**Available model names**: `google/gemini-3-pro-high`, `google/gemini-3-pro-medium`, `google/gemini-3-pro-low`, `google/gemini-2.5-flash`, `google/gemini-2.5-flash-lite`, `google/claude-sonnet-4-5`, `google/claude-sonnet-4-5-thinking`, `google/claude-opus-4-5-thinking`, `google/gpt-oss-120b-medium`
+
 Then authenticate:
 
 ```bash
 opencode auth login
-# Interactive Terminal: find Provider: Select Google
-# Interactive Terminal: find Login method: Select Google
-# Guide user through OAuth flow in browser. You use tools like pbcopy or other equivalents depending on your OS, and tell user that you have copied the link and paste it to the browser
-# Wait for completion
+# Interactive Terminal: Provider: Select Google
+# Interactive Terminal: Login method: Select OAuth with Google (Antigravity)
+# Complete sign-in in browser (auto-detected)
+# Optional: Add more Google accounts for multi-account load balancing
 # Verify success and confirm with user
 ```
 
+**Multi-Account Load Balancing**: The plugin supports up to 10 Google accounts. When one account hits rate limits, it automatically switches to the next available account.
+
 #### OpenAI (ChatGPT Plus/Pro)
 
 First, add the opencode-openai-codex-auth plugin:
@@ -574,7 +609,22 @@ Schema autocomplete supported:
 
 ### Google Auth
 
-Enable built-in Antigravity OAuth for Google Gemini models:
+**Recommended**: Use the external [`opencode-antigravity-auth`](https://github.com/NoeFabris/opencode-antigravity-auth) plugin. It provides multi-account load balancing, more models (including Claude via Antigravity), and active maintenance. See [Installation > Google Gemini](#google-gemini-antigravity-oauth).
+
+When using `opencode-antigravity-auth`, disable the built-in auth and override agent models in `oh-my-opencode.json`:
+
+```json
+{
+  "google_auth": false,
+  "agents": {
+    "frontend-ui-ux-engineer": { "model": "google/gemini-3-pro-high" },
+    "document-writer": { "model": "google/gemini-3-pro-high" },
+    "multimodal-looker": { "model": "google/gemini-2.5-flash" }
+  }
+}
+```
+
+**Alternative**: Enable built-in Antigravity OAuth (single account, Gemini models only):
 
 ```json
 {
@@ -582,8 +632,6 @@ Enable built-in Antigravity OAuth for Google Gemini models:
 }
 ```
 
-When enabled, `opencode auth login` shows "OAuth with Google (Antigravity)" for the Google provider.
-
 ### Agents
 
 Override built-in agent settings: