Skip to content

Commit b8e70f9

Browse files
committed
docs: update LLM agent install guide to use CLI installer
Related to #153 Co-authored-by: Taegeon Alan Go <[email protected]> 🤖 GENERATED WITH ASSISTANCE OF [OhMyOpenCode](https://github.com/code-yeongyu/oh-my-opencode)
1 parent 5dbd5ac commit b8e70f9

File tree

4 files changed

+130
-391
lines changed

4 files changed

+130
-391
lines changed

README.ja.md

Lines changed: 31 additions & 92 deletions
Original file line numberDiff line numberDiff line change
@@ -157,76 +157,23 @@ Windows から Linux に初めて乗り換えた時のこと、自分の思い
157157
あなたがユーザーの oh-my-opencode 設定を支援する LLM エージェントなら、以下の手順に従ってください:
158158

159159

160-
### ステップ 0: セットアップについてユーザーに尋ねる
161-
162-
OpenCode は様々なモデルをサポートしており、当プラグインは様々な最先端 LLM の使用を提案しています。そのため、ユーザーに以下の質問をする必要があります。
163-
164-
**重要**: ユーザーがどのプロバイダーを持っているか追跡してください。ユーザーが Claude を持っていると確認した場合のみ、`anthropic/claude-opus-4-5` をフォールバックとして使用できます。Claude がない場合は、代わりに `opencode/big-pickle` をフォールバックとして使用してください。
165-
166-
1. **Claude Pro/Max のサブスクリプションをお持ちですか?** お持ちでない場合、メインオーケストレーターモデルとして 'opencode/big-pickle' (GLM 4.6 として知られる) を使用することになります (非推奨)。
167-
- ユーザーが**「はい」**と答えた場合、追加質問: **max20 (20x モード) を使用していますか?**
168-
- **「はい」 (max20)**: ToDo 追加: "ユーザーの Claude Pro/Max 認証設定" — librarian に Claude Sonnet 4.5 をフル使用。**記憶: Claude がフォールバックとして使用可能。**
169-
- **「いいえ」 (max20 ではない)**: ToDo 追加: "ユーザーの Claude Pro/Max 認証設定"、そして `~/.config/opencode/oh-my-opencode.json` に以下をマージ。**記憶: Claude がフォールバックとして使用可能。**
170-
```json
171-
{
172-
"agents": {
173-
"librarian": { "model": "opencode/big-pickle" }
174-
}
175-
}
176-
```
177-
- ユーザーが**「いいえ」** (Claude サブスクリプションなし) と答えた場合、`~/.config/opencode/oh-my-opencode.json` に以下を保存。**記憶: Claude は使用不可 — すべてのフォールバックは `opencode/big-pickle` を使用する必要があります。**
178-
```json
179-
{
180-
"agents": {
181-
"Sisyphus": { "model": "opencode/big-pickle" },
182-
"librarian": { "model": "opencode/big-pickle" }
183-
}
184-
}
185-
```
186-
187-
2. **ChatGPT のサブスクリプションをお持ちですか?** お持ちでない場合、oracle エージェントにフォールバックモデルを使用することになります。
188-
- ユーザーが**「はい」**と答えた場合、ToDo 追加: "ユーザーの ChatGPT 認証設定"
189-
- ユーザーが**「いいえ」**と答えた場合:
190-
- **Claude が使用可能な場合**: `oh-my-opencode.json` に以下をマージ:
191-
```json
192-
{
193-
"agents": {
194-
"oracle": { "model": "anthropic/claude-opus-4-5" }
195-
}
196-
}
197-
```
198-
- **Claude が使用不可の場合**: `oh-my-opencode.json` に以下をマージ:
199-
```json
200-
{
201-
"agents": {
202-
"oracle": { "model": "opencode/big-pickle" }
203-
}
204-
}
205-
```
206-
207-
3. **Gemini モデルを統合しますか?** 統合しない場合、美しいデザインを享受できません。
208-
- ユーザーが**「はい」**と答えた場合、ToDo 追加: "Google OAuth 設定"
209-
- ユーザーが**「いいえ」**と答えた場合:
210-
- **Claude が使用可能な場合**: `oh-my-opencode.json` に以下をマージ:
211-
```json
212-
{
213-
"agents": {
214-
"frontend-ui-ux-engineer": { "model": "anthropic/claude-opus-4-5" },
215-
"document-writer": { "model": "anthropic/claude-opus-4-5" },
216-
"multimodal-looker": { "model": "anthropic/claude-opus-4-5" }
217-
}
218-
}
219-
```
220-
- **Claude が使用不可の場合**: `oh-my-opencode.json` に以下をマージ:
221-
```json
222-
{
223-
"agents": {
224-
"frontend-ui-ux-engineer": { "model": "opencode/big-pickle" },
225-
"document-writer": { "model": "opencode/big-pickle" },
226-
"multimodal-looker": { "model": "opencode/big-pickle" }
227-
}
228-
}
229-
```
160+
### ステップ 0: サブスクリプション情報を確認
161+
162+
以下の 3 つの質問をして CLI オプションを決定してください:
163+
164+
1. **Claude Pro/Max のサブスクリプションをお持ちですか?**
165+
- **はい**: **max20 (20x モード) を使用していますか?**
166+
- **max20**`--claude=max20`
167+
- **max20 ではない**`--claude=yes`
168+
- **いいえ**`--claude=no`
169+
170+
2. **ChatGPT のサブスクリプションをお持ちですか?**
171+
- **はい**`--chatgpt=yes`
172+
- **いいえ**`--chatgpt=no`
173+
174+
3. **Gemini モデルを使用しますか?**
175+
- **はい**`--gemini=yes`
176+
- **いいえ**`--gemini=no`
230177

231178
### ステップ 1: OpenCode インストール確認
232179

@@ -241,36 +188,28 @@ fi
241188

242189
OpenCode がインストールされていない場合は、[OpenCode インストールガイド](https://opencode.ai/docs)を確認し、インストールを進めてください。コンテキストを節約するため、サブエージェントを呼び出してインストールを行わせ、その結果を報告させるように案内してください。
243190

244-
### ステップ 2: oh-my-opencode プラグイン設定
245-
246-
#### JSONC
247-
- `~/.config/opencode/opencode.jsonc` が存在する場合は、そこで `oh-my-opencode` プラグインを追加してください。
191+
### ステップ 2: インストーラーを実行
248192

249-
#### JSON
250-
- opencode.jsonc が存在しない場合は、以下のコマンドを実行して作成・登録してください。
193+
ユーザーの回答に基づいて、適切なフラグで CLI インストーラーを実行してください:
251194

252195
```bash
253-
mkdir -p ~/.config/opencode
254-
255-
if [ -f ~/.config/opencode/opencode.json ]; then
256-
# 既存の設定ファイルがある場合: jq または python で plugin を追加
257-
if command -v jq &> /dev/null; then
258-
jq '.plugin = ((.plugin // []) + ["oh-my-opencode"] | unique)' \
259-
~/.config/opencode/opencode.json > /tmp/oc.json && \
260-
mv /tmp/oc.json ~/.config/opencode/opencode.json
261-
else
262-
echo "~/.config/opencode/opencode.json の plugin 配列に \"oh-my-opencode\" を追加してください"
263-
fi
264-
else
265-
# 新しい設定ファイル作成
266-
echo '{"plugin":["oh-my-opencode"]}' > ~/.config/opencode/opencode.json
267-
fi
196+
bunx oh-my-opencode install --no-tui --claude=<yes|no|max20> --chatgpt=<yes|no> --gemini=<yes|no>
268197
```
269198

199+
**例:**
200+
- すべてのサブスクリプション + max20: `bunx oh-my-opencode install --no-tui --claude=max20 --chatgpt=yes --gemini=yes`
201+
- Claude のみ(max20 なし): `bunx oh-my-opencode install --no-tui --claude=yes --chatgpt=no --gemini=no`
202+
- サブスクリプションなし: `bunx oh-my-opencode install --no-tui --claude=no --chatgpt=no --gemini=no`
203+
204+
CLI が行うこと:
205+
- `opencode.json` にプラグインを登録
206+
- サブスクリプションフラグに基づいてエージェントモデルを設定
207+
- 必要な認証ステップを表示
208+
270209
### ステップ 3: 設定確認
271210

272211
```bash
273-
opencode --version # 1.0.132 以上であること
212+
opencode --version # 1.0.150 以上であること
274213
cat ~/.config/opencode/opencode.json # plugin 配列に "oh-my-opencode" が含まれていること
275214
```
276215

README.ko.md

Lines changed: 31 additions & 92 deletions
Original file line numberDiff line numberDiff line change
@@ -154,76 +154,23 @@ OpenCode 가 낭만이 사라진것같은 오늘날의 시대에, 당신에게
154154
당신이 사용자의 oh-my-opencode 설정을 돕는 LLM Agent라면, 다음 단계를 따르세요. 업데이트 과정이라고 할지라도 아래의 내용을 그대로 따르세요. 단, 설치 과정에서 이미 답했을 질문은 또 하지 않습니다.
155155

156156

157-
### 0단계: 사용자에게 설정에 대해 물어보세요.
158-
159-
OpenCode는 다양한 모델을 지원하며, 이 플러그인은 다양한 프론티어 LLM 사용을 제안합니다. 따라서 사용자에게 다음 질문을 해야 합니다.
160-
161-
**중요**: 사용자가 어떤 프로바이더를 가지고 있는지 추적하세요. 사용자가 Claude가 있다고 확인한 경우에만 `anthropic/claude-opus-4-5`를 폴백으로 사용할 수 있습니다. Claude가 없다면 `opencode/big-pickle`을 폴백으로 사용해야 합니다.
162-
163-
1. **Claude Pro/Max 구독이 있으신가요?** 그렇지 않다면 메인 오케스트레이터 모델로 'opencode/big-pickle'(GLM 4.6으로 알려짐)을 사용하게 됩니다 (권장하지 않음).
164-
- 사용자가 **'예'**라고 답하면, 추가 질문: **max20 (20x 모드)를 사용하고 계신가요?**
165-
- **'예' (max20)**: 할 일 추가: "사용자 Claude Pro/Max 인증 설정" — librarian에 Claude Sonnet 4.5 전체 사용. **기억: Claude를 폴백으로 사용 가능.**
166-
- **'아니오' (max20 아님)**: 할 일 추가: "사용자 Claude Pro/Max 인증 설정", 그리고 `~/.config/opencode/oh-my-opencode.json`에 다음을 병합. **기억: Claude를 폴백으로 사용 가능.**
167-
```json
168-
{
169-
"agents": {
170-
"librarian": { "model": "opencode/big-pickle" }
171-
}
172-
}
173-
```
174-
- 사용자가 **'아니오'** (Claude 구독 없음)라고 답하면, `~/.config/opencode/oh-my-opencode.json`에 다음을 저장. **기억: Claude 사용 불가 — 모든 폴백은 `opencode/big-pickle`을 사용해야 함.**
175-
```json
176-
{
177-
"agents": {
178-
"Sisyphus": { "model": "opencode/big-pickle" },
179-
"librarian": { "model": "opencode/big-pickle" }
180-
}
181-
}
182-
```
183-
184-
2. **ChatGPT 구독이 있으신가요?** 그렇지 않다면 oracle 에이전트에 폴백 모델을 사용하게 됩니다.
185-
- 사용자가 **'예'**라고 답하면, 할 일 추가: "사용자 ChatGPT 인증 설정"
186-
- 사용자가 **'아니오'**라고 답하면:
187-
- **Claude가 사용 가능한 경우**: `oh-my-opencode.json`에 다음을 병합:
188-
```json
189-
{
190-
"agents": {
191-
"oracle": { "model": "anthropic/claude-opus-4-5" }
192-
}
193-
}
194-
```
195-
- **Claude가 사용 불가능한 경우**: `oh-my-opencode.json`에 다음을 병합:
196-
```json
197-
{
198-
"agents": {
199-
"oracle": { "model": "opencode/big-pickle" }
200-
}
201-
}
202-
```
203-
204-
3. **Gemini 모델을 통합하시겠습니까?** 그렇지 않다면 아름다운 디자인을 즐길 수 없습니다.
205-
- 사용자가 **'예'**라고 답하면, 할 일 추가: "Google OAuth 설정"
206-
- 사용자가 **'아니오'**라고 답하면:
207-
- **Claude가 사용 가능한 경우**: `oh-my-opencode.json`에 다음을 병합:
208-
```json
209-
{
210-
"agents": {
211-
"frontend-ui-ux-engineer": { "model": "anthropic/claude-opus-4-5" },
212-
"document-writer": { "model": "anthropic/claude-opus-4-5" },
213-
"multimodal-looker": { "model": "anthropic/claude-opus-4-5" }
214-
}
215-
}
216-
```
217-
- **Claude가 사용 불가능한 경우**: `oh-my-opencode.json`에 다음을 병합:
218-
```json
219-
{
220-
"agents": {
221-
"frontend-ui-ux-engineer": { "model": "opencode/big-pickle" },
222-
"document-writer": { "model": "opencode/big-pickle" },
223-
"multimodal-looker": { "model": "opencode/big-pickle" }
224-
}
225-
}
226-
```
157+
### 0단계: 구독 정보 확인
158+
159+
사용자에게 다음 3가지 질문을 하여 CLI 옵션을 결정하세요:
160+
161+
1. **Claude Pro/Max 구독이 있으신가요?**
162+
- ****: **max20 (20x 모드)를 사용하고 계신가요?**
163+
- **max20**`--claude=max20`
164+
- **max20 아님**`--claude=yes`
165+
- **아니오**`--claude=no`
166+
167+
2. **ChatGPT 구독이 있으신가요?**
168+
- ****`--chatgpt=yes`
169+
- **아니오**`--chatgpt=no`
170+
171+
3. **Gemini 모델을 사용하시겠습니까?**
172+
- ****`--gemini=yes`
173+
- **아니오**`--gemini=no`
227174

228175
### 1단계: OpenCode 설치 확인
229176

@@ -238,36 +185,28 @@ fi
238185

239186
OpenCode가 설치되어 있지 않다면, [OpenCode 설치 가이드](https://opencode.ai/docs)를 읽고, 설치를 진행하세요. 컨텍스트를 줄이기 위해 Subagent 로 호출하여 설치를 하라고 안내하고, 그 결과를 보고 받는다고 말하세요.
240187

241-
### 2단계: oh-my-opencode 플러그인 설정
242-
243-
#### JSONC
244-
- `~/.config/opencode/opencode.jsonc`가 존재한다면, 그곳에 `oh-my-opencode` 플러그인을 추가하세요.
188+
### 2단계: 설치 프로그램 실행
245189

246-
#### JSON
247-
- opencode.jsonc가 없다면, 다음 명령어를 실행하여 생성하고 등록하세요.
190+
사용자의 답변을 바탕으로 적절한 플래그와 함께 CLI 설치 프로그램을 실행하세요:
248191

249192
```bash
250-
mkdir -p ~/.config/opencode
251-
252-
if [ -f ~/.config/opencode/opencode.json ]; then
253-
# 기존 설정 파일이 있는 경우: jq 또는 python으로 plugin 추가
254-
if command -v jq &> /dev/null; then
255-
jq '.plugin = ((.plugin // []) + ["oh-my-opencode"] | unique)' \
256-
~/.config/opencode/opencode.json > /tmp/oc.json && \
257-
mv /tmp/oc.json ~/.config/opencode/opencode.json
258-
else
259-
echo "~/.config/opencode/opencode.json의 plugin 배열에 \"oh-my-opencode\"를 추가하세요"
260-
fi
261-
else
262-
# 새 설정 파일 생성
263-
echo '{"plugin":["oh-my-opencode"]}' > ~/.config/opencode/opencode.json
264-
fi
193+
bunx oh-my-opencode install --no-tui --claude=<yes|no|max20> --chatgpt=<yes|no> --gemini=<yes|no>
265194
```
266195

196+
**예시:**
197+
- 모든 구독 + max20: `bunx oh-my-opencode install --no-tui --claude=max20 --chatgpt=yes --gemini=yes`
198+
- Claude만 (max20 없음): `bunx oh-my-opencode install --no-tui --claude=yes --chatgpt=no --gemini=no`
199+
- 구독 없음: `bunx oh-my-opencode install --no-tui --claude=no --chatgpt=no --gemini=no`
200+
201+
CLI가 수행하는 작업:
202+
- `opencode.json`에 플러그인 등록
203+
- 구독 플래그에 따라 에이전트 모델 설정
204+
- 필요한 인증 단계 안내
205+
267206
### 3단계: 설정 확인
268207

269208
```bash
270-
opencode --version # 1.0.132 이상이어야 함
209+
opencode --version # 1.0.150 이상이어야 함
271210
cat ~/.config/opencode/opencode.json # plugin 배열에 "oh-my-opencode"가 있어야 함
272211
```
273212

0 commit comments

Comments
 (0)