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 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 の両方のプリセットを生成し、デフォルトで OpenAI が有効になります。OpenAI はワークフローマネージャー/スケジューラーに `openai/gpt-5.5 (medium)`、Oracle に `openai/gpt-5.5 (high)`、Fixer に `openai/gpt-5.5 (low)`、その他の専門家には `openai/gpt-5.4-mini` 系のバリアントを使用します。インストール時に OpenCode Go を有効にするには `bunx oh-my-opencode-slim@latest install --preset=opencode-go` を実行するか、インストール後に `~/.config/opencode/oh-my-opencode-slim.json` のデフォルトプリセット名を変更してください。
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
- | **[Interview](docs/interview.md)** | ブラウザベース의 Q&A フローで、ざっくりとしたアイデアを構造化された Markdown 仕様に変換します |
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가 활성화됩니다. OpenAI는 워크플로 매니저/스케줄러에 `openai/gpt-5.5 (medium)`, Oracle에 `openai/gpt-5.5 (high)`, Fixer에 `openai/gpt-5.5 (low)`, 그 외 전문가에는 `openai/gpt-5.4-mini` 변형을 사용합니다. 설치 중 OpenCode Go를 활성화하려면 `bunx oh-my-opencode-slim@latest install --preset=opencode-go`를 실행하거나, 설치 후 `~/.config/opencode/oh-my-opencode-slim.json`에서 기본 프리셋 이름을 변경하세요.
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. OpenAI uses `openai/gpt-5.5 (medium)` for the workflow manager/scheduler, `openai/gpt-5.5 (high)` for the Oracle, `openai/gpt-5.5 (low)` for the Fixer, and `openai/gpt-5.4-mini` variants for other specialists. 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.
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 fast, reliable coding model for routine, scoped implementation work. Fixer usually receives a concrete plan or bounded instructions from Orchestrator, making it a good place for efficient execution tasks such as tests, test updates, and straightforward code changes.
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
- [![All Contributors](https://img.shields.io/badge/all_contributors-59-orange.svg?style=flat-square)](#contributors-)
624
+ [![All Contributors](https://img.shields.io/badge/all_contributors-60-orange.svg?style=flat-square)](#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 的预设(Preset),默认启用 OpenAI 预设。OpenAI 使用变体感知路由:`openai/gpt-5.5` (medium) 作为工作流管理器/调度模型,`openai/gpt-5.5` (high) 作为 Oracle 模型,`openai/gpt-5.5` (low) 作为 Fixer 模型,并使用 `openai/gpt-5.4-mini` 变体模型作为响应更快速、针对具体任务的智能体模型。若要在安装过程中激活 OpenCode Go 预设,请运行 `bunx oh-my-opencode-slim@latest install --preset=opencode-go` 或在安装后修改 `~/.config/opencode/oh-my-opencode-slim.json` 文件中的默认预设名称。
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="特性与工作流"></a>
557
+ <a id="features-and-workflows"></a>
542
558
 
543
559
  ### ✨ 特性与工作流
544
560
 
545
561
  | 文档 | 涵盖内容 |
546
562
  |-----|----------------|
547
- | **[Council (议会) (docs/council.md)](docs/council.md)** | 使用 `@council` 并行运行多个模型并合成单一答案 |
548
- | **[多路复用器集成 (docs/multiplexer-integration.md)](docs/multiplexer-integration.md)** | Tmux Zellij 窗格中实时观看智能体的工作过程 |
549
- | **[会话管理 (docs/session-management.md)](docs/session-management.md)** | 使用短别名复用最近的子智能体会话,而不是重新开始 |
550
- | **[运行时预设切换 (docs/preset-switching.md)](docs/preset-switching.md)** | 在运行时使用 `/preset` 切换智能体模型预设 |
551
- | **[自定义智能体 (docs/configuration.md#custom-agents)](docs/configuration.md#custom-agents)** | 自定义专家智能体:配置独特的提示词、模型、MCP 权限和编排者委派规则 |
552
- | **[代码地图 (Codemap) (docs/codemap.md)](docs/codemap.md)** | 生成层级代码地图,快速理解大型代码库 |
553
- | **[克隆依赖 (Clonedeps) (docs/clonedeps.md)](docs/clonedeps.md)** | 将选定的依赖源码克隆到被忽略的本地工作区中以供检查 |
554
- | **[访谈式生成 (Interview) (docs/interview.md)](docs/interview.md)** | 通过基于浏览器的问答流,将粗糙的想法转变为结构化的 Markdown 规范文档 |
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
- | **[配置指南 (docs/configuration.md)](docs/configuration.md)** | 配置文件位置、JSONC 支持、提示词覆盖以及完整的选项参考 |
561
- | **[维护者指南 (docs/maintainers.md)](docs/maintainers.md)** | 问题分流规则、标签含义、支持路由以及仓库维护工作流 |
562
- | **[技能列表 (Skills) (docs/skills.md)](docs/skills.md)** | 捆绑的技能,如 `simplify`、`codemap` `clonedeps` |
563
- | **[MCP 服务 (docs/mcps.md)](docs/mcps.md)** | `websearch`、`context7`、`gh_grep` 以及每个智能体的 MCP 权限工作机制 |
564
- | **[工具说明 (docs/tools.md)](docs/tools.md)** | 内置工具能力,如 `webfetch`、LSP 工具、代码搜索和格式化工具 |
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
- | **[作者的预设配置 (docs/authors-preset.md)](docs/authors-preset.md)** | 作者日常使用的混合服务商配置方案 |
571
- | **[$30 预设配置 (docs/thirty-dollars-preset.md)](docs/thirty-dollars-preset.md)** | 每月约 30 美元的预算型混合服务商配置方案 |
572
- | **[OpenCode Go 预设 (docs/opencode-go-preset.md)](docs/opencode-go-preset.md)** | 安装程序生成的捆绑 `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 cacheVersion = pinnedVersion ?? runningVersion;
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
- rmSync(tempDir, { recursive: true, force: true });
1730
+ rmSync2(tempDir, { recursive: true, force: true });
1706
1731
  } catch {}
1707
1732
  }
1708
1733
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "oh-my-opencode-slim",
3
- "version": "2.0.0",
3
+ "version": "2.0.1",
4
4
  "description": "Lightweight agent orchestration plugin for OpenCode - a slimmed-down fork of oh-my-opencode",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",