oh-my-opencode-slim 2.0.0 → 2.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ja-JP.md +40 -20
- package/README.ko-KR.md +36 -18
- package/README.md +36 -18
- package/README.zh-CN.md +49 -31
- package/dist/cli/index.js +28 -3
- package/package.json +1 -1
package/README.ja-JP.md
CHANGED
|
@@ -32,6 +32,32 @@ oh-my-opencode-slim は OpenCode 向けのエージェントオーケストレ
|
|
|
32
32
|
|
|
33
33
|
各エージェントについて知りたい場合は **[Meet the Pantheon](#meet-the-pantheon)** を参照してください。機能の全体像は下記の **[Features & Workflows](#features-and-workflows)** をご覧ください。
|
|
34
34
|
|
|
35
|
+
### ユーザーの声
|
|
36
|
+
|
|
37
|
+
> “タスク管理は 5/10 から簡単に 8〜9/10 まで上がりました。
|
|
38
|
+
> Orchestrator が Fixer や Explorer を送り出してくれて、
|
|
39
|
+
> それでも同じセッションで Orchestrator と会話しながら計画できます。
|
|
40
|
+
> 体験がずっとスムーズになりました。”
|
|
41
|
+
>
|
|
42
|
+
> \- `vipor_idk`
|
|
43
|
+
|
|
44
|
+
> “この beta 版の omo-slim のために、自分の harness は全部捨てました。
|
|
45
|
+
> 振り返ることも、何かを恋しく思うこともありません。素晴らしい仕事で、
|
|
46
|
+
> 個人的にはすべて正しい方向に進んでいると思います。”
|
|
47
|
+
>
|
|
48
|
+
> \- `stephanschielke`
|
|
49
|
+
|
|
50
|
+
> “omo-slim が大好きで、これなしで opencode を動かすことは想像できません。
|
|
51
|
+
> いろいろなモデルの Frankenstein を作れるところが気に入っています……
|
|
52
|
+
> セットアップ全体が本当に強力になります。”
|
|
53
|
+
>
|
|
54
|
+
> \- `Capital-One3039`
|
|
55
|
+
|
|
56
|
+
> “私のワークフローは大きく改善されました……今はとてもスムーズに動いていて、
|
|
57
|
+
> とても気に入っています。”
|
|
58
|
+
>
|
|
59
|
+
> \- `xenstar1`
|
|
60
|
+
|
|
35
61
|
### クイックスタート
|
|
36
62
|
|
|
37
63
|
以下のプロンプトを LLM エージェント(Claude Code、AmpCode、Cursor など)にコピー&ペーストしてください:
|
|
@@ -50,7 +76,9 @@ bunx oh-my-opencode-slim@latest install
|
|
|
50
76
|
|
|
51
77
|
### はじめに
|
|
52
78
|
|
|
53
|
-
インストーラーは OpenAI と OpenCode Go
|
|
79
|
+
インストーラーは OpenAI と OpenCode Go の両方のプリセットを生成し、デフォルトでは OpenAI が有効になります。
|
|
80
|
+
|
|
81
|
+
インストール時に OpenCode Go を有効にするには、`bunx oh-my-opencode-slim@latest install --preset=opencode-go` を実行するか、インストール後に `~/.config/opencode/oh-my-opencode-slim.json` のデフォルトプリセット名を変更してください。
|
|
54
82
|
|
|
55
83
|
次に:
|
|
56
84
|
|
|
@@ -65,14 +93,15 @@ bunx oh-my-opencode-slim@latest install
|
|
|
65
93
|
opencode models --refresh
|
|
66
94
|
```
|
|
67
95
|
3. **プラグイン設定**を開きます: `~/.config/opencode/oh-my-opencode-slim.json`
|
|
68
|
-
カスタム OpenCode 設定ディレクトリを使っている場合は
|
|
69
|
-
`$OPENCODE_CONFIG_DIR/oh-my-opencode-slim.json`
|
|
70
96
|
|
|
71
97
|
4. **各エージェントに使用したいモデルを更新します**
|
|
72
98
|
|
|
73
99
|
> [!TIP]
|
|
74
100
|
> バックグラウンドオーケストレーションの仕組みを理解しておくことを**推奨**します。**[Orchestrator のプロンプト](https://github.com/alvinunreal/oh-my-opencode-slim/blob/master/src/agents/orchestrator.ts#L28)** には、スケジューラーのルール、専門エージェントへのルーティングロジック、作業をバックグラウンドエージェントへ割り当てるしきい値が記述されています。`@agentName <task>` のようにサブエージェントを呼び出すことで、いつでも手動で委譲できます。
|
|
75
101
|
|
|
102
|
+
> [!TIP]
|
|
103
|
+
> バックグラウンドエージェントが現在のデフォルトワークフローになっているため、**[Multiplexer Integration](docs/multiplexer-integration.md)** を有効化して設定することを**強く推奨**します。各エージェントが専用の Tmux または Zellij ペインで自動的に開かれるため、Orchestrator がセッションを調整し続けている間も、専門エージェントの作業をリアルタイムで追えます。
|
|
104
|
+
|
|
76
105
|
デフォルトで生成される設定には `openai` と `opencode-go` の両方のプリセットが含まれます。
|
|
77
106
|
|
|
78
107
|
```jsonc
|
|
@@ -105,11 +134,6 @@ bunx oh-my-opencode-slim@latest install
|
|
|
105
134
|
|
|
106
135
|
カスタムプロバイダーや複数プロバイダーを組み合わせた構成を使用するには、完全なリファレンスとして **[Configuration](docs/configuration.md)** を参照してください。すぐに使える出発点が欲しい場合は **[Author's Preset](docs/authors-preset.md)** と **[$30 Preset](docs/thirty-dollars-preset.md)** をご覧ください。`$30` プリセットはコスト効率に最も優れたセットアップです。
|
|
107
136
|
|
|
108
|
-
設定ガイドでは `agents.<name>` を使用したカスタムサブエージェントについても説明しており、
|
|
109
|
-
通常の `prompt` に加えて委譲用の `orchestratorPrompt` ブロックも定義できます。
|
|
110
|
-
|
|
111
|
-
モデルの推奨については、下記の各エージェントの **Recommended Models** をご覧ください。
|
|
112
|
-
|
|
113
137
|
### ✅ セットアップの確認
|
|
114
138
|
|
|
115
139
|
インストールと認証を済ませた後、すべてのエージェントが設定済みで応答することを確認してください:
|
|
@@ -533,13 +557,7 @@ Deepwork は、大規模リファクタリング、多段階機能、高リス
|
|
|
533
557
|
|
|
534
558
|
## 📚 ドキュメント
|
|
535
559
|
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
### 🚀 ここから始める
|
|
539
|
-
|
|
540
|
-
| Doc | 内容 |
|
|
541
|
-
|-----|----------------|
|
|
542
|
-
| **[Installation Guide](docs/installation.md)** | プラグインのインストール、CLI フラグの使用、設定のリセット、セットアップのトラブルシューティング |
|
|
560
|
+
このセクションは地図として使ってください。まずインストールから始め、必要に応じて機能、設定、またはプリセット例へ移動できます。
|
|
543
561
|
|
|
544
562
|
<a id="features-and-workflows"></a>
|
|
545
563
|
|
|
@@ -548,21 +566,23 @@ Deepwork は、大規模リファクタリング、多段階機能、高リス
|
|
|
548
566
|
| Doc | 内容 |
|
|
549
567
|
|-----|----------------|
|
|
550
568
|
| **[Council](docs/council.md)** | 複数のモデルを並列実行し、`@council` で 1 つの回答に統合します |
|
|
551
|
-
| **[Multiplexer Integration](docs/multiplexer-integration.md)** | エージェントの動作を Tmux や Zellij のペインでライブ表示します |
|
|
552
|
-
| **[Session Management](docs/session-management.md)** | 短いエイリアスで最近の子エージェントセッションを再利用し、最初からやり直さずに済みます |
|
|
553
|
-
| **[Preset Switching](docs/preset-switching.md)** | `/preset` で実行時にエージェントモデルのプリセットを切り替えます |
|
|
554
569
|
| **[Custom Agents](docs/configuration.md#custom-agents)** | カスタムプロンプト、モデル、MCP アクセス、Orchestrator の委譲ルールを備えた独自の専門エージェントを定義します |
|
|
570
|
+
| **[Multiplexer Integration](docs/multiplexer-integration.md)** | エージェントの動作を Tmux や Zellij のペインでライブ表示します |
|
|
555
571
|
| **[Codemap](docs/codemap.md)** | 階層的なコードマップを生成し、大規模コードベースを迅速に理解します |
|
|
556
572
|
| **[Clonedeps](docs/clonedeps.md)** | 選択した依存関係のソースを ignore 済みのローカルワークスペースにクローンし、調査できるようにします |
|
|
557
|
-
| **[
|
|
573
|
+
| **[Preset Switching](docs/preset-switching.md)** | `/preset` で実行時にエージェントモデルのプリセットを切り替えます |
|
|
574
|
+
| **[Interview](docs/interview.md)** | ブラウザベースの Q&A フローで、ざっくりとしたアイデアを構造化された Markdown 仕様に変換します |
|
|
575
|
+
| **[Companion](docs/companion.md)** | 解析、ヘルプ、型情報のためのフローティングウィンドウ companion |
|
|
558
576
|
|
|
559
577
|
### ⚙️ 設定 & リファレンス
|
|
560
578
|
|
|
561
579
|
| Doc | 内容 |
|
|
562
580
|
|-----|----------------|
|
|
581
|
+
| **[Installation Guide](docs/installation.md)** | プラグインのインストール、CLI フラグの使用、設定のリセット、セットアップのトラブルシューティング |
|
|
563
582
|
| **[Configuration](docs/configuration.md)** | 設定ファイルの配置場所、JSONC サポート、プロンプトの上書き、全オプションのリファレンス |
|
|
583
|
+
| **[Background Orchestration](docs/background-orchestration.md)** | ネイティブのバックグラウンドサブエージェントを中心にした、スケジューラー優先の Orchestrator モデル |
|
|
564
584
|
| **[Maintainer Guide](docs/maintainers.md)** | Issue のトリアージルール、ラベルの意味、サポートの振り分け、リポジトリ運用ワークフロー |
|
|
565
|
-
| **[Skills](docs/skills.md)** | `simplify`、`codemap`、`clonedeps` などの同梱スキル |
|
|
585
|
+
| **[Skills](docs/skills.md)** | `simplify`、`codemap`、`clonedeps`、`deepwork`、`oh-my-opencode-slim` などの同梱スキル |
|
|
566
586
|
| **[MCPs](docs/mcps.md)** | `websearch`、`context7`、`gh_grep`、およびエージェントごとの MCP 権限の仕組み |
|
|
567
587
|
| **[Tools](docs/tools.md)** | `webfetch`、LSP ツール、コード検索、フォーマッターなどの組み込みツール機能 |
|
|
568
588
|
|
package/README.ko-KR.md
CHANGED
|
@@ -32,6 +32,30 @@ oh-my-opencode-slim은 OpenCode용 에이전트 오케스트레이션 플러그
|
|
|
32
32
|
|
|
33
33
|
에이전트 자체를 살펴보려면 **[판테온 만나보기](#meet-the-pantheon)** 를 참고하세요. 전체 기능 세트는 아래의 **[기능 & 워크플로우](#features-and-workflows)** 에서 확인할 수 있습니다.
|
|
34
34
|
|
|
35
|
+
### 사용자들의 말
|
|
36
|
+
|
|
37
|
+
> “작업 관리가 쉽게 5/10에서 8-9/10으로 올라갔습니다.
|
|
38
|
+
> Orchestrator가 Fixer와 Explorer를 보내주고, 저는 여전히 같은 세션에서
|
|
39
|
+
> Orchestrator와 대화하고 계획할 수 있습니다. 이제 경험이 훨씬 더 매끄럽습니다.”
|
|
40
|
+
>
|
|
41
|
+
> \- `vipor_idk`
|
|
42
|
+
|
|
43
|
+
> “이 beta 버전의 omo-slim을 쓰면서 제가 쓰던 harness들을 전부 버렸고,
|
|
44
|
+
> 뒤돌아보거나 아쉬워하지 않습니다. 훌륭한 작업이고, 제 생각에는 모두 올바른 방향입니다.”
|
|
45
|
+
>
|
|
46
|
+
> \- `stephanschielke`
|
|
47
|
+
|
|
48
|
+
> “omo-slim을 정말 좋아하고, 이것 없이 opencode를 실행하는 건 상상할 수 없습니다.
|
|
49
|
+
> 여러 모델로 Frankenstein을 만들 수 있다는 점이 좋습니다……
|
|
50
|
+
> 설정 전체를 정말 강력한 괴물로 만들어줍니다.”
|
|
51
|
+
>
|
|
52
|
+
> \- `Capital-One3039`
|
|
53
|
+
|
|
54
|
+
> “제 워크플로우가 크게 개선되었습니다…… 지금은 매우 매끄럽게 작동하고 있고,
|
|
55
|
+
> 정말 마음에 듭니다.”
|
|
56
|
+
>
|
|
57
|
+
> \- `xenstar1`
|
|
58
|
+
|
|
35
59
|
### 빠른 시작
|
|
36
60
|
|
|
37
61
|
이 프롬프트를 복사해서 LLM 에이전트(Claude Code, AmpCode, Cursor 등)에 붙여넣으세요:
|
|
@@ -50,7 +74,9 @@ bunx oh-my-opencode-slim@latest install
|
|
|
50
74
|
|
|
51
75
|
### 시작하기
|
|
52
76
|
|
|
53
|
-
인스톨러는 OpenAI와 OpenCode Go 프리셋을 모두 생성하며, 기본적으로 OpenAI가 활성화됩니다.
|
|
77
|
+
인스톨러는 OpenAI와 OpenCode Go 프리셋을 모두 생성하며, 기본적으로 OpenAI가 활성화됩니다.
|
|
78
|
+
|
|
79
|
+
설치 중 OpenCode Go를 활성화하려면 `bunx oh-my-opencode-slim@latest install --preset=opencode-go`를 실행하거나, 설치 후 `~/.config/opencode/oh-my-opencode-slim.json`에서 기본 프리셋 이름을 변경하세요.
|
|
54
80
|
|
|
55
81
|
그 다음:
|
|
56
82
|
|
|
@@ -65,14 +91,15 @@ bunx oh-my-opencode-slim@latest install
|
|
|
65
91
|
opencode models --refresh
|
|
66
92
|
```
|
|
67
93
|
3. **플러그인 설정 파일**을 `~/.config/opencode/oh-my-opencode-slim.json`에서 엽니다.
|
|
68
|
-
사용자 지정 OpenCode 설정 디렉터리를 사용한다면
|
|
69
|
-
`$OPENCODE_CONFIG_DIR/oh-my-opencode-slim.json`을 엽니다.
|
|
70
94
|
|
|
71
95
|
4. **각 에이전트에 사용할 모델을 업데이트합니다**
|
|
72
96
|
|
|
73
97
|
> [!TIP]
|
|
74
98
|
> 자동 위임이 어떻게 동작하는지 이해하는 것을 **권장**합니다. **[Orchestrator 프롬프트](https://github.com/alvinunreal/oh-my-opencode-slim/blob/master/src/agents/orchestrator.ts#L28)** 에는 위임 규칙, 전문 에이전트 라우팅 로직, 메인 에이전트가 언제 서브에이전트로 작업을 넘겨야 하는지에 대한 임계값이 포함되어 있습니다. 수동으로 위임하려면 `@agentName <task>`로 서브에이전트를 호출하면 됩니다.
|
|
75
99
|
|
|
100
|
+
> [!TIP]
|
|
101
|
+
> 이제 백그라운드 에이전트가 기본 워크플로이므로 **[Multiplexer Integration](docs/multiplexer-integration.md)** 을 활성화하고 설정하는 것을 **강력히 권장**합니다. 각 에이전트를 전용 Tmux 또는 Zellij 창에서 자동으로 열어 주기 때문에, Orchestrator가 세션을 계속 조율하는 동안 전문 에이전트들의 작업을 실시간으로 따라볼 수 있습니다.
|
|
102
|
+
|
|
76
103
|
기본 생성 설정에는 `openai`와 `opencode-go` 프리셋이 모두 포함되어 있습니다.
|
|
77
104
|
|
|
78
105
|
```jsonc
|
|
@@ -105,10 +132,6 @@ bunx oh-my-opencode-slim@latest install
|
|
|
105
132
|
|
|
106
133
|
커스텀 프로바이더나 여러 프로바이더를 혼합해서 사용하려면, **[Configuration](docs/configuration.md)** 에서 전체 레퍼런스를 확인하세요. 바로 사용할 수 있는 시작점을 찾고 있다면 **[Author's Preset](docs/authors-preset.md)** 과 **[$30 Preset](docs/thirty-dollars-preset.md)** 을 확인해 보세요. `$30` 프리셋이 가장 가성비 좋은 설정입니다.
|
|
107
134
|
|
|
108
|
-
설정 가이드에서는 `agents.<name>`을 통한 커스텀 서브에이전트 정의도 다룹니다. 일반 `prompt`와 위임용 `orchestratorPrompt` 블록을 모두 정의할 수 있습니다.
|
|
109
|
-
|
|
110
|
-
모델 추천은 아래 각 에이전트에 나열된 **Recommended Models** 를 참고하세요.
|
|
111
|
-
|
|
112
135
|
### ✅ 설정 확인하기
|
|
113
136
|
|
|
114
137
|
설치와 인증이 끝난 후, 모든 에이전트가 올바르게 설정되어 응답하는지 확인합니다:
|
|
@@ -532,13 +555,7 @@ Deepwork는 대규모 리팩터링, 다단계 기능, 위험한 아키텍처 변
|
|
|
532
555
|
|
|
533
556
|
## 📚 문서
|
|
534
557
|
|
|
535
|
-
이
|
|
536
|
-
|
|
537
|
-
### 🚀 시작하기
|
|
538
|
-
|
|
539
|
-
| 문서 | 내용 |
|
|
540
|
-
|-----|------|
|
|
541
|
-
| **[Installation Guide](docs/installation.md)** | 플러그인 설치, CLI 플래그 사용, 설정 초기화, 설치 문제 해결 |
|
|
558
|
+
이 섹션은 지도로 활용하세요. 설치부터 시작한 뒤, 필요에 따라 기능, 설정 또는 예시 프리셋으로 이동하면 됩니다.
|
|
542
559
|
|
|
543
560
|
<a id="features-and-workflows"></a>
|
|
544
561
|
|
|
@@ -547,20 +564,21 @@ Deepwork는 대규모 리팩터링, 다단계 기능, 위험한 아키텍처 변
|
|
|
547
564
|
| 문서 | 내용 |
|
|
548
565
|
|-----|------|
|
|
549
566
|
| **[Council](docs/council.md)** | `@council`로 여러 모델을 병렬 실행하고 하나의 답변으로 종합 |
|
|
550
|
-
| **[Background Orchestration](docs/v2-background-orchestration.md)** | OpenCode 네이티브 백그라운드 서브에이전트를 기반으로 한 스케줄러 우선 오케스트레이터 모델 |
|
|
551
|
-
| **[Multiplexer Integration](docs/multiplexer-integration.md)** | Tmux 또는 Zellij 페인에서 에이전트 작업을 실시간으로 확인 |
|
|
552
|
-
| **[Session Management](docs/session-management.md)** | 단축 별칭으로 최근 자식 에이전트 세션을 재사용하여 처음부터 다시 시작하지 않기 |
|
|
553
|
-
| **[Preset Switching](docs/preset-switching.md)** | `/preset`으로 런타임에 에이전트 모델 프리셋 전환 |
|
|
554
567
|
| **[Custom Agents](docs/configuration.md#custom-agents)** | 커스텀 프롬프트, 모델, MCP 접근, Orchestrator 위임 규칙으로 커스텀 전문 에이전트 정의 |
|
|
568
|
+
| **[Multiplexer Integration](docs/multiplexer-integration.md)** | Tmux 또는 Zellij 페인에서 에이전트 작업을 실시간으로 확인 |
|
|
555
569
|
| **[Codemap](docs/codemap.md)** | 계층형 코드맵을 생성하여 대규모 코드베이스를 빠르게 파악 |
|
|
556
570
|
| **[Clonedeps](docs/clonedeps.md)** | 선택한 의존성 소스를 무시된 로컬 워크스페이스에 복제하여 검사 |
|
|
571
|
+
| **[Preset Switching](docs/preset-switching.md)** | `/preset`으로 런타임에 에이전트 모델 프리셋 전환 |
|
|
557
572
|
| **[Interview](docs/interview.md)** | 브라우저 기반 Q&A 흐름을 통해 거친 아이디어를 구조화된 마크다운 명세로 변환 |
|
|
573
|
+
| **[Companion](docs/companion.md)** | 파싱, 도움말, 타입을 위한 플로팅 창 companion |
|
|
558
574
|
|
|
559
575
|
### ⚙️ 설정 & 레퍼런스
|
|
560
576
|
|
|
561
577
|
| 문서 | 내용 |
|
|
562
578
|
|-----|------|
|
|
579
|
+
| **[Installation Guide](docs/installation.md)** | 플러그인 설치, CLI 플래그 사용, 설정 초기화, 설치 문제 해결 |
|
|
563
580
|
| **[Configuration](docs/configuration.md)** | 설정 파일 위치, JSONC 지원, 프롬프트 오버라이드, 전체 옵션 레퍼런스 |
|
|
581
|
+
| **[Background Orchestration](docs/background-orchestration.md)** | 네이티브 백그라운드 서브에이전트를 기반으로 한 스케줄러 우선 Orchestrator 모델 |
|
|
564
582
|
| **[Maintainer Guide](docs/maintainers.md)** | 이슈 트리아지 규칙, 라벨 의미, 지원 라우팅, 저장소 유지보수 워크플로우 |
|
|
565
583
|
| **[Skills](docs/skills.md)** | `simplify`, `codemap`, `clonedeps`, `deepwork`, `oh-my-opencode-slim` 등 번들된 스킬 |
|
|
566
584
|
| **[MCPs](docs/mcps.md)** | `websearch`, `context7`, `gh_grep` 및 에이전트별 MCP 권한 동작 방식 |
|
package/README.md
CHANGED
|
@@ -30,6 +30,29 @@ The main idea is simple: instead of forcing one model to do everything, the plug
|
|
|
30
30
|
|
|
31
31
|
To explore the agents themselves, see **[Meet the Pantheon](#meet-the-pantheon)**. For the full feature set, see **[Features & Workflows](#features-and-workflows)** below.
|
|
32
32
|
|
|
33
|
+
### What Users Say
|
|
34
|
+
|
|
35
|
+
> “Task management went from 5/10 to 8-9/10 easily. The Orchestrator sends
|
|
36
|
+
> Fixers and Explorers, and I can still talk and plan with the Orchestrator in
|
|
37
|
+
> the same session. The experience feels way smoother now.”
|
|
38
|
+
>
|
|
39
|
+
> \- `vipor_idk`
|
|
40
|
+
|
|
41
|
+
> “I ditched all my harnesses for this beta version of omo-slim and don't look
|
|
42
|
+
> back or miss anything. Great work and IMHO all in the right direction.”
|
|
43
|
+
>
|
|
44
|
+
> \- `stephanschielke`
|
|
45
|
+
|
|
46
|
+
> “I love omo-slim, and can't imagine running opencode without it. I love that I
|
|
47
|
+
> can create a Frankenstein of models... Makes the setup such a beast.”
|
|
48
|
+
>
|
|
49
|
+
> \- `Capital-One3039`
|
|
50
|
+
|
|
51
|
+
> “It has significantly improved my workflow... Now, it is working very
|
|
52
|
+
> smoothly, and I love it.”
|
|
53
|
+
>
|
|
54
|
+
> \- `xenstar1`
|
|
55
|
+
|
|
33
56
|
### Quick Start
|
|
34
57
|
|
|
35
58
|
Copy and paste this prompt to your LLM agent (Claude Code, AmpCode, Cursor, etc.):
|
|
@@ -48,7 +71,9 @@ bunx oh-my-opencode-slim@latest install
|
|
|
48
71
|
|
|
49
72
|
### Getting Started
|
|
50
73
|
|
|
51
|
-
The installer generates both OpenAI and OpenCode Go presets, with OpenAI active by default.
|
|
74
|
+
The installer generates both OpenAI and OpenCode Go presets, with OpenAI active by default.
|
|
75
|
+
|
|
76
|
+
To make OpenCode Go active during install, run `bunx oh-my-opencode-slim@latest install --preset=opencode-go` or change the default preset name in `~/.config/opencode/oh-my-opencode-slim.json` after installation.
|
|
52
77
|
|
|
53
78
|
Then:
|
|
54
79
|
|
|
@@ -63,14 +88,15 @@ Then:
|
|
|
63
88
|
opencode models --refresh
|
|
64
89
|
```
|
|
65
90
|
3. **Open your plugin config** at `~/.config/opencode/oh-my-opencode-slim.json`
|
|
66
|
-
or `$OPENCODE_CONFIG_DIR/oh-my-opencode-slim.json` if you use a custom
|
|
67
|
-
OpenCode config directory
|
|
68
91
|
|
|
69
92
|
4. **Update the models you want for each agent**
|
|
70
93
|
|
|
71
94
|
> [!TIP]
|
|
72
95
|
> It's **recommended** to understand how background orchestration works. The **[Orchestrator prompt](https://github.com/alvinunreal/oh-my-opencode-slim/blob/master/src/agents/orchestrator.ts#L28)** contains the scheduler rules, specialist routing logic, and thresholds for when work should be assigned to background agents. You can always delegate manually by calling a subagent via: `@agentName <task>`
|
|
73
96
|
|
|
97
|
+
> [!TIP]
|
|
98
|
+
> Because background agents are now the default workflow, it is **highly recommended** to enable and configure **[Multiplexer Integration](docs/multiplexer-integration.md)**. It automatically opens each agent in a dedicated Tmux or Zellij pane, so you can watch specialists work live while the Orchestrator continues coordinating the session.
|
|
99
|
+
|
|
74
100
|
The default generated configuration includes both `openai` and `opencode-go` presets.
|
|
75
101
|
|
|
76
102
|
```jsonc
|
|
@@ -103,10 +129,6 @@ The default generated configuration includes both `openai` and `opencode-go` pre
|
|
|
103
129
|
|
|
104
130
|
To use custom providers or a mixed-provider setup, use **[Configuration](docs/configuration.md)** for the full reference. If you want a ready-made starting point, check the **[Author's Preset](docs/authors-preset.md)** and **[$30 Preset](docs/thirty-dollars-preset.md)** - the `$30` preset is the best cheap setup.
|
|
105
131
|
|
|
106
|
-
The configuration guide also covers custom subagents via `agents.<name>`, where
|
|
107
|
-
you can define both a normal `prompt` and an `orchestratorPrompt` block for
|
|
108
|
-
delegation.
|
|
109
|
-
|
|
110
132
|
### ✅ Verify Your Setup
|
|
111
133
|
|
|
112
134
|
After installation and authentication, verify all agents are configured and responding:
|
|
@@ -502,7 +524,7 @@ rules.
|
|
|
502
524
|
</tr>
|
|
503
525
|
<tr>
|
|
504
526
|
<td colspan="2">
|
|
505
|
-
<b>Model Guidance:</b> Choose a
|
|
527
|
+
<b>Model Guidance:</b> Choose a reliable coding model for scoped implementation work. Fixer receives a concrete plan or bounded instructions from Orchestrator, making it a good place for efficient execution tasks and straightforward code changes.
|
|
506
528
|
</td>
|
|
507
529
|
</tr>
|
|
508
530
|
</table>
|
|
@@ -555,12 +577,6 @@ rules.
|
|
|
555
577
|
|
|
556
578
|
Use this section as a map: start with installation, then jump to features, configuration, or example presets depending on what you need.
|
|
557
579
|
|
|
558
|
-
### 🚀 Start Here
|
|
559
|
-
|
|
560
|
-
| Doc | What it covers |
|
|
561
|
-
|-----|----------------|
|
|
562
|
-
| **[Installation Guide](docs/installation.md)** | Install the plugin, use CLI flags, reset config, and troubleshoot setup |
|
|
563
|
-
|
|
564
580
|
<a id="features-and-workflows"></a>
|
|
565
581
|
|
|
566
582
|
### ✨ Features & Workflows
|
|
@@ -568,12 +584,11 @@ Use this section as a map: start with installation, then jump to features, confi
|
|
|
568
584
|
| Doc | What it covers |
|
|
569
585
|
|-----|----------------|
|
|
570
586
|
| **[Council](docs/council.md)** | Run multiple models in parallel and synthesize a single answer with `@council` |
|
|
571
|
-
| **[Background Orchestration](docs/background-orchestration.md)** | Scheduler-first orchestrator model built around native background subagents |
|
|
572
|
-
| **[Multiplexer Integration](docs/multiplexer-integration.md)** | Watch agents work live in Tmux or Zellij panes |
|
|
573
|
-
| **[Preset Switching](docs/preset-switching.md)** | Switch agent model presets at runtime with `/preset` |
|
|
574
587
|
| **[Custom Agents](docs/configuration.md#custom-agents)** | Define your own specialists with custom prompts, models, MCP access, and Orchestrator delegation rules |
|
|
588
|
+
| **[Multiplexer Integration](docs/multiplexer-integration.md)** | Watch agents work live in Tmux or Zellij panes |
|
|
575
589
|
| **[Codemap](docs/codemap.md)** | Generate hierarchical codemaps to understand large codebases faster |
|
|
576
590
|
| **[Clonedeps](docs/clonedeps.md)** | Clone selected dependency source into an ignored local workspace for inspection |
|
|
591
|
+
| **[Preset Switching](docs/preset-switching.md)** | Switch agent model presets at runtime with `/preset` |
|
|
577
592
|
| **[Interview](docs/interview.md)** | Turn rough ideas into a structured markdown spec through a browser-based Q&A flow |
|
|
578
593
|
| **[Companion](docs/companion.md)** | Floating window companion for parsing, help, and types |
|
|
579
594
|
|
|
@@ -581,7 +596,9 @@ Use this section as a map: start with installation, then jump to features, confi
|
|
|
581
596
|
|
|
582
597
|
| Doc | What it covers |
|
|
583
598
|
|-----|----------------|
|
|
599
|
+
| **[Installation Guide](docs/installation.md)** | Install the plugin, use CLI flags, reset config, and troubleshoot setup |
|
|
584
600
|
| **[Configuration](docs/configuration.md)** | Config file locations, JSONC support, prompt overrides, and full option reference |
|
|
601
|
+
| **[Background Orchestration](docs/background-orchestration.md)** | Scheduler-first orchestrator model built around native background subagents |
|
|
585
602
|
| **[Maintainer Guide](docs/maintainers.md)** | Issue triage rules, label meanings, support routing, and repo maintenance workflow |
|
|
586
603
|
| **[Skills](docs/skills.md)** | Bundled skills such as `simplify`, `codemap`, `clonedeps`, `deepwork`, and `oh-my-opencode-slim` |
|
|
587
604
|
| **[MCPs](docs/mcps.md)** | `websearch`, `context7`, `gh_grep`, and how MCP permissions work per agent |
|
|
@@ -604,7 +621,7 @@ Use this section as a map: start with installation, then jump to features, confi
|
|
|
604
621
|
<p><sub>Every merged contribution leaves a mark on the realm.</sub></p>
|
|
605
622
|
|
|
606
623
|
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
|
|
607
|
-
[](#contributors-)
|
|
608
625
|
<!-- ALL-CONTRIBUTORS-BADGE:END -->
|
|
609
626
|
</div>
|
|
610
627
|
|
|
@@ -693,6 +710,7 @@ Use this section as a map: start with installation, then jump to features, confi
|
|
|
693
710
|
<td align="center" valign="top" width="16.66%"><a href="https://github.com/Qesire"><img src="https://avatars.githubusercontent.com/u/102657430?v=4?s=100" width="100px;" alt="Knowingthesea_Qesire"/><br /><sub><b>Knowingthesea_Qesire</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=Qesire" title="Code">💻</a></td>
|
|
694
711
|
<td align="center" valign="top" width="16.66%"><a href="http://www.flyinghail.net/"><img src="https://avatars.githubusercontent.com/u/157430?v=4?s=100" width="100px;" alt="FENG Hao"/><br /><sub><b>FENG Hao</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=flyinghail" title="Code">💻</a></td>
|
|
695
712
|
<td align="center" valign="top" width="16.66%"><a href="https://github.com/smatheusblu"><img src="https://avatars.githubusercontent.com/u/5666794?v=4?s=100" width="100px;" alt="Matheus Nogueira Silveira"/><br /><sub><b>Matheus Nogueira Silveira</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=smatheusblu" title="Code">💻</a></td>
|
|
713
|
+
<td align="center" valign="top" width="16.66%"><a href="https://github.com/sktr"><img src="https://avatars.githubusercontent.com/u/44969514?v=4?s=100" width="100px;" alt="sktr"/><br /><sub><b>sktr</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=sktr" title="Code">💻</a></td>
|
|
696
714
|
</tr>
|
|
697
715
|
</tbody>
|
|
698
716
|
</table>
|
package/README.zh-CN.md
CHANGED
|
@@ -32,6 +32,29 @@ oh-my-opencode-slim 是一个用于 OpenCode 的智能体编排插件。它内
|
|
|
32
32
|
|
|
33
33
|
要了解智能体本身,请参阅 **[认识众神殿](#meet-the-pantheon)**。如需了解完整特性集,请参阅下方的 **[特性与工作流](#features-and-workflows)**。
|
|
34
34
|
|
|
35
|
+
### 用户怎么说
|
|
36
|
+
|
|
37
|
+
> “任务管理轻松从 5/10 提升到了 8-9/10。Orchestrator 会派出
|
|
38
|
+
> Fixer 和 Explorer,而我仍然可以在同一个会话里继续和 Orchestrator
|
|
39
|
+
> 对话与规划。现在整个体验顺滑多了。”
|
|
40
|
+
>
|
|
41
|
+
> \- `vipor_idk`
|
|
42
|
+
|
|
43
|
+
> “我已经为了这个 omo-slim beta 版本抛弃了所有自己的 harness,
|
|
44
|
+
> 也完全没有回头或怀念。做得很好,在我看来方向都非常正确。”
|
|
45
|
+
>
|
|
46
|
+
> \- `stephanschielke`
|
|
47
|
+
|
|
48
|
+
> “我很喜欢 omo-slim,已经无法想象不用它来运行 opencode。
|
|
49
|
+
> 我喜欢可以拼出一个由各种模型组成的 Frankenstein……
|
|
50
|
+
> 这让整个设置变成了一头猛兽。”
|
|
51
|
+
>
|
|
52
|
+
> \- `Capital-One3039`
|
|
53
|
+
|
|
54
|
+
> “它显著改善了我的工作流……现在运行得非常顺畅,我很喜欢。”
|
|
55
|
+
>
|
|
56
|
+
> \- `xenstar1`
|
|
57
|
+
|
|
35
58
|
### 快速开始
|
|
36
59
|
|
|
37
60
|
将此提示词复制并粘贴到您的 LLM 智能体中(例如 Claude Code、AmpCode、Cursor 等):
|
|
@@ -48,7 +71,9 @@ bunx oh-my-opencode-slim@latest install
|
|
|
48
71
|
|
|
49
72
|
### 入门指南
|
|
50
73
|
|
|
51
|
-
安装程序会同时生成 OpenAI 和 OpenCode Go
|
|
74
|
+
安装程序会同时生成 OpenAI 和 OpenCode Go 预设,默认启用 OpenAI。
|
|
75
|
+
|
|
76
|
+
要在安装期间启用 OpenCode Go,请运行 `bunx oh-my-opencode-slim@latest install --preset=opencode-go`,或在安装后修改 `~/.config/opencode/oh-my-opencode-slim.json` 中的默认预设名称。
|
|
52
77
|
|
|
53
78
|
然后:
|
|
54
79
|
|
|
@@ -63,14 +88,15 @@ bunx oh-my-opencode-slim@latest install
|
|
|
63
88
|
opencode models --refresh
|
|
64
89
|
```
|
|
65
90
|
3. **打开您的插件配置文件**,路径为 `~/.config/opencode/oh-my-opencode-slim.json`
|
|
66
|
-
或者在使用自定义 OpenCode 配置目录时打开
|
|
67
|
-
`$OPENCODE_CONFIG_DIR/oh-my-opencode-slim.json`
|
|
68
91
|
|
|
69
92
|
4. **为您要分配的每个智能体更新模型配置**
|
|
70
93
|
|
|
71
94
|
> [!TIP]
|
|
72
95
|
> **建议**了解后台编排的工作原理。**[编排者提示词 (Orchestrator prompt)](https://github.com/alvinunreal/oh-my-opencode-slim/blob/master/src/agents/orchestrator.ts#L28)** 包含调度规则、专家路由逻辑,以及何时应把工作分配给后台智能体的阈值。您始终可以通过以下方式手动委派任务:`@智能体名称 <任务内容>`
|
|
73
96
|
|
|
97
|
+
> [!TIP]
|
|
98
|
+
> 由于后台智能体现在是默认工作流,**强烈建议**启用并配置 **[Multiplexer Integration](docs/multiplexer-integration.md)**。它会自动在专用的 Tmux 或 Zellij 窗格中打开每个智能体,让您在 Orchestrator 继续协调会话时,实时跟进各个专家智能体的工作。
|
|
99
|
+
|
|
74
100
|
默认生成的配置包含 `openai` 和 `opencode-go` 两个预设:
|
|
75
101
|
|
|
76
102
|
```jsonc
|
|
@@ -103,10 +129,6 @@ bunx oh-my-opencode-slim@latest install
|
|
|
103
129
|
|
|
104
130
|
要使用自定义模型提供商或混合提供商配置,请参阅 **[配置指南 (docs/configuration.md)](docs/configuration.md)** 以获取完整参考。如果您需要即插即用的起点,请查看 **[作者的预设配置 (docs/authors-preset.md)](docs/authors-preset.md)** 和 **[$30 预设配置 (docs/thirty-dollars-preset.md)](docs/thirty-dollars-preset.md)**(`$30` 预设是性价比最高的便宜配置方案)。
|
|
105
131
|
|
|
106
|
-
配置指南还介绍了如何通过 `agents.<name>` 定义自定义子智能体,您可以在其中为委派定义普通 `prompt` 和 `orchestratorPrompt` 块。
|
|
107
|
-
|
|
108
|
-
有关模型推荐,请参阅下方列出的每个智能体推荐模型。
|
|
109
|
-
|
|
110
132
|
### ✅ 验证您的安装
|
|
111
133
|
|
|
112
134
|
在完成安装与认证后,请验证所有智能体是否已正确配置并能够响应:
|
|
@@ -530,46 +552,42 @@ Deepwork 适用于重型编码会话:大范围重构、多阶段功能、高
|
|
|
530
552
|
|
|
531
553
|
## 📚 文档
|
|
532
554
|
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
### 🚀 从这里开始
|
|
536
|
-
|
|
537
|
-
| 文档 | 涵盖内容 |
|
|
538
|
-
|-----|----------------|
|
|
539
|
-
| **[安装指南 (docs/installation.md)](docs/installation.md)** | 安装插件、使用 CLI 标志、重置配置以及排查安装故障 |
|
|
555
|
+
请将本节作为地图:先从安装开始,再根据需要跳转到特性、配置或示例预设。
|
|
540
556
|
|
|
541
|
-
<a id="
|
|
557
|
+
<a id="features-and-workflows"></a>
|
|
542
558
|
|
|
543
559
|
### ✨ 特性与工作流
|
|
544
560
|
|
|
545
561
|
| 文档 | 涵盖内容 |
|
|
546
562
|
|-----|----------------|
|
|
547
|
-
| **[Council
|
|
548
|
-
| **[
|
|
549
|
-
| **[
|
|
550
|
-
| **[
|
|
551
|
-
| **[
|
|
552
|
-
| **[
|
|
553
|
-
| **[
|
|
554
|
-
| **[
|
|
563
|
+
| **[Council](docs/council.md)** | 使用 `@council` 并行运行多个模型并合成单一答案 |
|
|
564
|
+
| **[自定义智能体](docs/configuration.md#custom-agents)** | 使用自定义提示词、模型、MCP 访问和 Orchestrator 委派规则定义自己的专家 |
|
|
565
|
+
| **[多路复用器集成](docs/multiplexer-integration.md)** | 在 Tmux 或 Zellij 窗格中实时观看智能体工作 |
|
|
566
|
+
| **[Codemap](docs/codemap.md)** | 生成层级代码地图,更快理解大型代码库 |
|
|
567
|
+
| **[Clonedeps](docs/clonedeps.md)** | 将选定的依赖源码克隆到被忽略的本地工作区中以供检查 |
|
|
568
|
+
| **[预设切换](docs/preset-switching.md)** | 使用 `/preset` 在运行时切换智能体模型预设 |
|
|
569
|
+
| **[Interview](docs/interview.md)** | 通过基于浏览器的问答流程,将粗略想法转成结构化 markdown 规格 |
|
|
570
|
+
| **[Companion](docs/companion.md)** | 用于解析、帮助和类型信息的浮动窗口 companion |
|
|
555
571
|
|
|
556
572
|
### ⚙️ 配置与参考
|
|
557
573
|
|
|
558
574
|
| 文档 | 涵盖内容 |
|
|
559
575
|
|-----|----------------|
|
|
560
|
-
| **[
|
|
561
|
-
| **[
|
|
562
|
-
| **[
|
|
563
|
-
| **[
|
|
564
|
-
| **[
|
|
576
|
+
| **[安装指南](docs/installation.md)** | 安装插件、使用 CLI 标志、重置配置并排查设置问题 |
|
|
577
|
+
| **[配置](docs/configuration.md)** | 配置文件位置、JSONC 支持、提示词覆盖和完整选项参考 |
|
|
578
|
+
| **[后台编排](docs/background-orchestration.md)** | 围绕原生后台子智能体构建的调度器优先 Orchestrator 模型 |
|
|
579
|
+
| **[维护者指南](docs/maintainers.md)** | issue 分流规则、标签含义、支持路由和仓库维护工作流 |
|
|
580
|
+
| **[Skills](docs/skills.md)** | `simplify`、`codemap`、`clonedeps`、`deepwork` 和 `oh-my-opencode-slim` 等捆绑技能 |
|
|
581
|
+
| **[MCPs](docs/mcps.md)** | `websearch`、`context7`、`gh_grep` 以及每个智能体的 MCP 权限机制 |
|
|
582
|
+
| **[Tools](docs/tools.md)** | `webfetch`、LSP 工具、代码搜索和格式化工具等内置工具能力 |
|
|
565
583
|
|
|
566
584
|
### 💡 预设配置
|
|
567
585
|
|
|
568
586
|
| 文档 | 涵盖内容 |
|
|
569
587
|
|-----|----------------|
|
|
570
|
-
| **[作者的预设配置
|
|
571
|
-
| **[$30 预设配置
|
|
572
|
-
| **[OpenCode Go 预设
|
|
588
|
+
| **[作者的预设配置](docs/authors-preset.md)** | 作者日常使用的混合服务商配置方案 |
|
|
589
|
+
| **[$30 预设配置](docs/thirty-dollars-preset.md)** | 每月约 30 美元的预算型混合服务商配置方案 |
|
|
590
|
+
| **[OpenCode Go 预设](docs/opencode-go-preset.md)** | 安装程序生成的捆绑 `opencode-go` 预设 |
|
|
573
591
|
|
|
574
592
|
---
|
|
575
593
|
|
package/dist/cli/index.js
CHANGED
|
@@ -181,6 +181,7 @@ import {
|
|
|
181
181
|
mkdirSync as mkdirSync3,
|
|
182
182
|
readFileSync,
|
|
183
183
|
renameSync,
|
|
184
|
+
rmSync,
|
|
184
185
|
statSync as statSync2,
|
|
185
186
|
writeFileSync
|
|
186
187
|
} from "node:fs";
|
|
@@ -850,6 +851,20 @@ function getPinnedVersionFromConfig() {
|
|
|
850
851
|
} catch {}
|
|
851
852
|
return;
|
|
852
853
|
}
|
|
854
|
+
function getRequestedPackageTag(packageRoot) {
|
|
855
|
+
const normalizedPath = normalizePathForMatch(packageRoot);
|
|
856
|
+
const marker = `/bunx-`;
|
|
857
|
+
const markerIndex = normalizedPath.lastIndexOf(marker);
|
|
858
|
+
if (markerIndex === -1)
|
|
859
|
+
return;
|
|
860
|
+
const bunxSegment = normalizedPath.slice(markerIndex + marker.length).split("/")[0];
|
|
861
|
+
const packagePrefix = `${PACKAGE_NAME}@`;
|
|
862
|
+
const packageIndex = bunxSegment.lastIndexOf(packagePrefix);
|
|
863
|
+
if (packageIndex === -1)
|
|
864
|
+
return;
|
|
865
|
+
const tag = bunxSegment.slice(packageIndex + packagePrefix.length);
|
|
866
|
+
return tag || undefined;
|
|
867
|
+
}
|
|
853
868
|
function getVersionFromPackageRoot(packageRoot) {
|
|
854
869
|
try {
|
|
855
870
|
const packageJsonPath = join3(packageRoot, "package.json");
|
|
@@ -884,6 +899,14 @@ function writeOpenCodePluginCacheManifest(cacheDir, version = "latest") {
|
|
|
884
899
|
};
|
|
885
900
|
}
|
|
886
901
|
}
|
|
902
|
+
function removeOpenCodePluginCacheArtifacts(cacheDir) {
|
|
903
|
+
rmSync(join3(cacheDir, "node_modules", PACKAGE_NAME), {
|
|
904
|
+
recursive: true,
|
|
905
|
+
force: true
|
|
906
|
+
});
|
|
907
|
+
rmSync(join3(cacheDir, "bun.lock"), { force: true });
|
|
908
|
+
rmSync(join3(cacheDir, "bun.lockb"), { force: true });
|
|
909
|
+
}
|
|
887
910
|
function verifyOpenCodePluginCache(cacheDir) {
|
|
888
911
|
const pluginPackageJsonPath = join3(cacheDir, "node_modules", PACKAGE_NAME, "package.json");
|
|
889
912
|
if (!existsSync3(pluginPackageJsonPath)) {
|
|
@@ -922,7 +945,8 @@ async function warmOpenCodePluginCache() {
|
|
|
922
945
|
}
|
|
923
946
|
const pinnedVersion = getPinnedVersionFromConfig();
|
|
924
947
|
const runningVersion = getVersionFromPackageRoot(packageRoot);
|
|
925
|
-
const
|
|
948
|
+
const requestedTag = getRequestedPackageTag(packageRoot);
|
|
949
|
+
const cacheVersion = pinnedVersion ?? requestedTag ?? runningVersion;
|
|
926
950
|
const cacheDir = getOpenCodePluginCacheDir(cacheVersion);
|
|
927
951
|
try {
|
|
928
952
|
mkdirSync3(cacheDir, { recursive: true });
|
|
@@ -936,6 +960,7 @@ async function warmOpenCodePluginCache() {
|
|
|
936
960
|
const manifestError = writeOpenCodePluginCacheManifest(cacheDir, cacheVersion);
|
|
937
961
|
if (manifestError)
|
|
938
962
|
return manifestError;
|
|
963
|
+
removeOpenCodePluginCacheArtifacts(cacheDir);
|
|
939
964
|
try {
|
|
940
965
|
const proc = crossSpawn(["bun", "install", "--ignore-scripts"], {
|
|
941
966
|
cwd: cacheDir,
|
|
@@ -1576,7 +1601,7 @@ import {
|
|
|
1576
1601
|
mkdirSync as mkdirSync5,
|
|
1577
1602
|
mkdtempSync,
|
|
1578
1603
|
renameSync as renameSync2,
|
|
1579
|
-
rmSync,
|
|
1604
|
+
rmSync as rmSync2,
|
|
1580
1605
|
writeFileSync as writeFileSync3
|
|
1581
1606
|
} from "node:fs";
|
|
1582
1607
|
import { homedir as homedir4, tmpdir } from "node:os";
|
|
@@ -1702,7 +1727,7 @@ async function installCompanion(config) {
|
|
|
1702
1727
|
} finally {
|
|
1703
1728
|
if (tempDir) {
|
|
1704
1729
|
try {
|
|
1705
|
-
|
|
1730
|
+
rmSync2(tempDir, { recursive: true, force: true });
|
|
1706
1731
|
} catch {}
|
|
1707
1732
|
}
|
|
1708
1733
|
}
|
package/package.json
CHANGED