oh-my-opencode-slim 2.0.5 → 2.1.0

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.
Files changed (52) hide show
  1. package/README.ja-JP.md +47 -21
  2. package/README.ko-KR.md +45 -19
  3. package/README.md +56 -32
  4. package/README.zh-CN.md +48 -24
  5. package/dist/agents/council.d.ts +1 -1
  6. package/dist/agents/index.d.ts +7 -2
  7. package/dist/agents/orchestrator.d.ts +1 -1
  8. package/dist/cli/custom-skills-registry.d.ts +18 -0
  9. package/dist/cli/custom-skills.d.ts +3 -19
  10. package/dist/cli/index.js +1089 -185
  11. package/dist/cli/providers.d.ts +5 -9
  12. package/dist/cli/skills.d.ts +2 -2
  13. package/dist/companion/manager.d.ts +7 -0
  14. package/dist/config/loader.d.ts +5 -2
  15. package/dist/config/schema.d.ts +4 -0
  16. package/dist/council/council-manager.d.ts +1 -1
  17. package/dist/hooks/auto-update-checker/skill-sync.d.ts +59 -1
  18. package/dist/hooks/filter-available-skills/index.d.ts +1 -2
  19. package/dist/hooks/foreground-fallback/index.d.ts +5 -1
  20. package/dist/hooks/image-hook.d.ts +1 -1
  21. package/dist/hooks/index.d.ts +1 -0
  22. package/dist/hooks/loop-command/index.d.ts +13 -0
  23. package/dist/hooks/phase-reminder/index.d.ts +1 -2
  24. package/dist/hooks/task-session-manager/index.d.ts +1 -2
  25. package/dist/hooks/task-session-manager/pending-call-tracker.d.ts +13 -0
  26. package/dist/hooks/task-session-manager/task-context-tracker.d.ts +14 -0
  27. package/dist/hooks/types.d.ts +3 -1
  28. package/dist/index.js +2116 -670
  29. package/dist/interview/dashboard-manager.d.ts +21 -0
  30. package/dist/interview/manager.d.ts +0 -14
  31. package/dist/interview/service.d.ts +7 -0
  32. package/dist/interview/session-server.d.ts +21 -0
  33. package/dist/interview/types.d.ts +3 -1
  34. package/dist/loop/loop-session.d.ts +64 -0
  35. package/dist/multiplexer/factory.d.ts +5 -5
  36. package/dist/multiplexer/herdr/index.d.ts +31 -0
  37. package/dist/multiplexer/index.d.ts +1 -0
  38. package/dist/multiplexer/session-manager.d.ts +1 -0
  39. package/dist/multiplexer/types.d.ts +4 -4
  40. package/dist/tui.js +82 -39
  41. package/dist/utils/background-job-board.d.ts +17 -1
  42. package/dist/utils/session.d.ts +1 -1
  43. package/oh-my-opencode-slim.schema.json +6 -1
  44. package/package.json +1 -1
  45. package/src/skills/clonedeps/SKILL.md +2 -2
  46. package/src/skills/clonedeps/codemap.md +23 -32
  47. package/src/skills/codemap/SKILL.md +2 -2
  48. package/src/skills/codemap.md +63 -36
  49. package/src/skills/loop-engineering/SKILL.md +30 -0
  50. package/src/skills/reflect/SKILL.md +133 -0
  51. package/src/skills/release-smoke-test/SKILL.md +159 -0
  52. package/src/skills/simplify/SKILL.md +6 -6
package/README.ja-JP.md CHANGED
@@ -88,10 +88,37 @@ Install and configure oh-my-opencode-slim: https://raw.githubusercontent.com/alv
88
88
  bunx oh-my-opencode-slim@latest install
89
89
  ```
90
90
 
91
+ ### Master ブランチから実行
92
+
93
+ 最新コードを使いたい場合、バグ修正を試したい場合、またはローカルで
94
+ 開発・コントリビュートしたい場合はこちらを使ってください:
95
+
96
+ ```bash
97
+ git clone https://github.com/alvinunreal/oh-my-opencode-slim.git ~/repos/oh-my-opencode-slim
98
+ cd ~/repos/oh-my-opencode-slim
99
+ bun install
100
+ bun run build
101
+ bun dist/cli/index.js install
102
+ ```
103
+
104
+ インストーラーはローカルリポジトリのパスを
105
+ `~/.config/opencode/opencode.json` の `plugin` 配列に追加するため、
106
+ OpenCode はそのフォルダーからプラグインを読み込みます。後で更新するには:
107
+
108
+ ```bash
109
+ cd ~/repos/oh-my-opencode-slim
110
+ git pull
111
+ bun install
112
+ bun run build
113
+ ```
114
+
91
115
  ### はじめに
92
116
 
93
117
  インストーラーは OpenAI と OpenCode Go の両方のプリセットを生成し、デフォルトでは OpenAI が有効になります。
94
118
 
119
+ > [!TIP]
120
+ > モデルやエージェントは、自分のワークフローに合わせて自由に調整してください。デフォルトプリセットは出発点にすぎません。このプラグインは、深い柔軟性とカスタマイズ性を提供するために設計されています。
121
+
95
122
  インストール時に OpenCode Go を有効にするには、`bunx oh-my-opencode-slim@latest install --preset=opencode-go` を実行するか、インストール後に `~/.config/opencode/oh-my-opencode-slim.json` のデフォルトプリセット名を変更してください。
96
123
 
97
124
  次に:
@@ -114,7 +141,7 @@ bunx oh-my-opencode-slim@latest install
114
141
  > バックグラウンドオーケストレーションの仕組みを理解しておくことを**推奨**します。**[Orchestrator のプロンプト](https://github.com/alvinunreal/oh-my-opencode-slim/blob/master/src/agents/orchestrator.ts#L28)** には、スケジューラーのルール、専門エージェントへのルーティングロジック、作業をバックグラウンドエージェントへ割り当てるしきい値が記述されています。`@agentName <task>` のようにサブエージェントを呼び出すことで、いつでも手動で委譲できます。
115
142
 
116
143
  > [!TIP]
117
- > バックグラウンドエージェントが現在のデフォルトワークフローになっているため、**[Multiplexer Integration](docs/multiplexer-integration.md)** を有効化して設定することを**強く推奨**します。各エージェントが専用の Tmux または Zellij ペインで自動的に開かれるため、Orchestrator がセッションを調整し続けている間も、専門エージェントの作業をリアルタイムで追えます。
144
+ > バックグラウンドエージェントが現在のデフォルトワークフローになっているため、**[Multiplexer Integration](docs/multiplexer-integration.md)** を有効化して設定することを**強く推奨**します。各エージェントが専用の Tmux、Zellij または Herdr ペインで自動的に開かれるため、Orchestrator がセッションを調整し続けている間も、専門エージェントの作業をリアルタイムで追えます。
118
145
 
119
146
  デフォルトで生成される設定には `openai` と `opencode-go` の両方のプリセットが含まれます。
120
147
 
@@ -132,12 +159,11 @@ bunx oh-my-opencode-slim@latest install
132
159
  "fixer": { "model": "openai/gpt-5.5", "variant": "low", "skills": [], "mcps": [] }
133
160
  },
134
161
  "opencode-go": {
135
- "orchestrator": { "model": "opencode-go/glm-5.1", "skills": [ "*" ], "mcps": [ "*", "!context7" ] },
136
- "oracle": { "model": "opencode-go/deepseek-v4-pro", "variant": "max", "skills": ["simplify"], "mcps": [] },
137
- "council": { "model": "opencode-go/deepseek-v4-pro", "variant": "high", "skills": [], "mcps": [] },
138
- "librarian": { "model": "opencode-go/minimax-m2.7", "skills": [], "mcps": [ "websearch", "context7", "gh_grep" ] },
139
- "explorer": { "model": "opencode-go/minimax-m2.7", "skills": [], "mcps": [] },
140
- "designer": { "model": "opencode-go/kimi-k2.6", "variant": "medium", "skills": [], "mcps": [] },
162
+ "orchestrator": { "model": "opencode-go/glm-5.2", "skills": [ "*" ], "mcps": [ "*", "!context7" ] },
163
+ "oracle": { "model": "opencode-go/qwen3.7-max", "variant": "max", "skills": ["simplify"], "mcps": [] },
164
+ "librarian": { "model": "opencode-go/deepseek-v4-flash", "skills": [], "mcps": [ "websearch", "context7", "gh_grep" ] },
165
+ "explorer": { "model": "opencode-go/deepseek-v4-flash", "skills": [], "mcps": [] },
166
+ "designer": { "model": "opencode-go/kimi-k2.7-code", "variant": "medium", "skills": [], "mcps": [] },
141
167
  "fixer": { "model": "opencode-go/deepseek-v4-flash", "variant": "high", "skills": [], "mcps": [] }
142
168
  }
143
169
  }
@@ -175,12 +201,12 @@ ping all agents
175
201
 
176
202
  V2 は oh-my-opencode-slim を、スケジューラー中心のマルチエージェントワークフローシステムへと進化させます。Orchestrator は計画、委譲、結果の整合、検証に集中し、専門エージェントはそれぞれの lane で作業を行います。
177
203
 
178
- - **[バックグラウンドエージェント](#バックグラウンドエージェント)** Orchestrator は専門家をバックグラウンドタスクとしてディスパッチし、タスク/セッション ID を追跡し、完了イベントを待ってから結果を整合します。
179
- - **[Companion](#companion)** 任意のフローティングデスクトップウィンドウが、並列実行中のバックグラウンド専門家を含め、現在アクティブなエージェントを表示します。
180
- - **[Deepwork](#deepwork)** 大規模、多ファイル、高リスク、または段階的なコーディング作業向けの構造化ワークフローです。永続的な計画ファイルと Oracle レビューゲートを使用します。
181
- - **[Reflect](#reflect)** 繰り返される作業パターンを振り返り、再利用可能な skill、エージェント、コマンド、設定ルール、プロンプトルール、プロジェクト playbook を提案します。
182
- - **[Worktrees](#worktrees)** 複雑、高リスク、または並列タスク向けに、安全プロトコル付きの隔離されたコーディング lane として Git worktree を管理します。
183
- - **[oh-my-opencode-slim Skill](#oh-my-opencode-slim-skill)** モデル、プロンプト、カスタムエージェント、MCP アクセス、プリセット、プラグイン動作を安全に調整するための同梱設定 skill です。
204
+ - **[バックグラウンドエージェント](#バックグラウンドエージェント)** - Orchestrator は専門家をバックグラウンドタスクとしてディスパッチし、タスク/セッション ID を追跡し、完了イベントを待ってから結果を整合します。
205
+ - **[Companion](#companion)** - 任意のフローティングデスクトップウィンドウが、並列実行中のバックグラウンド専門家を含め、現在アクティブなエージェントを表示します。
206
+ - **[Deepwork](#deepwork)** - 大規模、多ファイル、高リスク、または段階的なコーディング作業向けの構造化ワークフローです。永続的な計画ファイルと Oracle レビューゲートを使用します。
207
+ - **[Reflect](#reflect)** - 繰り返される作業パターンを振り返り、再利用可能な skill、エージェント、コマンド、設定ルール、プロンプトルール、プロジェクト playbook を提案します。
208
+ - **[Worktrees](#worktrees)** - 複雑、高リスク、または並列タスク向けに、安全プロトコル付きの隔離されたコーディング lane として Git worktree を管理します。
209
+ - **[oh-my-opencode-slim Skill](#oh-my-opencode-slim-skill)** - モデル、プロンプト、カスタムエージェント、MCP アクセス、プリセット、プラグイン動作を安全に調整するための同梱設定 skill です。
184
210
 
185
211
  #### バックグラウンドエージェント
186
212
 
@@ -197,7 +223,7 @@ V2 では、バックグラウンド専門家が基本の考え方になりま
197
223
  <p><i>左下のビジュアル Companion。</i></p>
198
224
  </div>
199
225
 
200
- 対話式インストールでは、インストーラーが Companion を有効にするか尋ね、デフォルトは `yes` です。自動化では明示的に有効化できます。
226
+ 対話式インストールでは、インストーラーが Companion を有効にするか尋ね、デフォルトは `no` です。自動化では明示的に有効化できます。
201
227
 
202
228
  ```bash
203
229
  bunx oh-my-opencode-slim@latest install --companion=yes
@@ -415,7 +441,7 @@ Worktrees は、Git worktree を `.slim/worktrees/<slug>/` 配下の安全で隔
415
441
  </tr>
416
442
  <tr>
417
443
  <td colspan="2">
418
- <b>Default Setup:</b> <code>Config-driven</code> 評議員(councillors)は <code>council.presets</code> から、Council エージェント自身のモデルは通常の <code>council</code> エージェント設定から決定されます
444
+ <b>Default Setup:</b> <code>Config-driven</code> - 評議員(councillors)は <code>council.presets</code> から、Council エージェント自身のモデルは通常の <code>council</code> エージェント設定から決定されます
419
445
  </td>
420
446
  </tr>
421
447
  <tr>
@@ -482,7 +508,7 @@ Worktrees は、Git worktree を `.slim/worktrees/<slug>/` 配下の安全で隔
482
508
  <br><sub><i>美は不可欠なもの。</i></sub>
483
509
  </td>
484
510
  <td width="70%" valign="top">
485
- Designer は、美が重要であることを忘れがちな世界において、それを守り続ける不死の守護者です。これまでに無数のインターフェースが現れては消えるのを見届け、どれが人々の記憶に残り、どれが忘れ去られたかを知っています。すべてのピクセルに目的を、すべてのアニメーションに物語を、すべてのインタラクションに喜びを宿す——その神聖な責務を担います。美は選択肢ではなく、不可欠なものです。
511
+ Designer は、美が重要であることを忘れがちな世界において、それを守り続ける不死の守護者です。これまでに無数のインターフェースが現れては消えるのを見届け、どれが人々の記憶に残り、どれが忘れ去られたかを知っています。すべてのピクセルに目的を、すべてのアニメーションに物語を、すべてのインタラクションに喜びを宿す--その神聖な責務を担います。美は選択肢ではなく、不可欠なものです。
486
512
  </td>
487
513
  </tr>
488
514
  <tr>
@@ -523,7 +549,7 @@ Worktrees は、Git worktree を `.slim/worktrees/<slug>/` 配下の安全で隔
523
549
  <br><sub><i>構想と現実を結ぶ最後の一歩。</i></sub>
524
550
  </td>
525
551
  <td width="70%" valign="top">
526
- Fixer は、かつてデジタル世界の礎を築き上げた建造者の系譜の最後のひとりです。計画と議論の時代が始まってもなお、彼らだけは残りました——実際に作る者として。思考をモノへと変え、仕様を実装へと転換する古の知恵を継承しています。Fixer は、構想と現実の間にある最後の一歩です。
552
+ Fixer は、かつてデジタル世界の礎を築き上げた建造者の系譜の最後のひとりです。計画と議論の時代が始まってもなお、彼らだけは残りました--実際に作る者として。思考をモノへと変え、仕様を実装へと転換する古の知恵を継承しています。Fixer は、構想と現実の間にある最後の一歩です。
527
553
  </td>
528
554
  </tr>
529
555
  <tr>
@@ -570,11 +596,11 @@ Worktrees は、Git worktree を `.slim/worktrees/<slug>/` 配下の安全で隔
570
596
  </td>
571
597
  <td width="70%" valign="top">
572
598
 
573
- **読み取り専用のビジュアル解析** 画像、スクリーンショット、PDF、図解を解釈します。ファイルの生バイトをメインのコンテキストウィンドウに読み込ませることなく、構造化された観察結果をオーケストレーターに返します。
599
+ **読み取り専用のビジュアル解析** - 画像、スクリーンショット、PDF、図解を解釈します。ファイルの生バイトをメインのコンテキストウィンドウに読み込ませることなく、構造化された観察結果をオーケストレーターに返します。
574
600
 
575
601
  - 画像、スクリーンショット、図解 → `read` ツール(ネイティブな画像サポート)
576
602
  - PDF やバイナリドキュメント → `read` ツール(テキスト+構造抽出)
577
- - **デフォルトでは無効** `"disabled_agents": []` を設定し、ビジョン対応モデルを構成することで有効化できます。`--preset=opencode-go` でインストールすると `opencode-go/kimi-k2.6` で有効になります
603
+ - **デフォルトでは無効** - `"disabled_agents": []` を設定し、ビジョン対応モデルを構成することで有効化できます。`--preset=opencode-go` でインストールすると `opencode-go/kimi-k2.6` で有効になります
578
604
 
579
605
  </td>
580
606
  </tr>
@@ -585,7 +611,7 @@ Worktrees は、Git worktree を `.slim/worktrees/<slug>/` 配下の安全で隔
585
611
  </tr>
586
612
  <tr>
587
613
  <td colspan="2">
588
- <b>Default Model:</b> <code>openai/gpt-5.4-mini</code> <i>有効化するにはビジョン対応モデルを設定してください</i>
614
+ <b>Default Model:</b> <code>openai/gpt-5.4-mini</code> - <i>有効化するにはビジョン対応モデルを設定してください</i>
589
615
  </td>
590
616
  </tr>
591
617
  <tr>
@@ -610,7 +636,7 @@ Worktrees は、Git worktree を `.slim/worktrees/<slug>/` 配下の安全で隔
610
636
  | **[Council](docs/council.md)** | 複数のモデルを並列実行し、`@council` で 1 つの回答に統合します |
611
637
  | **[Custom Agents](docs/configuration.md#custom-agents)** | カスタムプロンプト、モデル、MCP アクセス、Orchestrator の委譲ルールを備えた独自の専門エージェントを定義します |
612
638
  | **[ACP Agents](docs/acp-agents.md)** | Claude Code ACP や Gemini ACP などの外部 ACP 互換エージェントを委譲可能なサブエージェントとして接続します |
613
- | **[Multiplexer Integration](docs/multiplexer-integration.md)** | エージェントの動作を Tmux や Zellij のペインでライブ表示します |
639
+ | **[Multiplexer Integration](docs/multiplexer-integration.md)** | エージェントの動作を Tmux、ZellijHerdr のペインでライブ表示します |
614
640
  | **[Codemap](docs/codemap.md)** | 階層的なコードマップを生成し、大規模コードベースを迅速に理解します |
615
641
  | **[Clonedeps](docs/clonedeps.md)** | 選択した依存関係のソースを ignore 済みのローカルワークスペースにクローンし、調査できるようにします |
616
642
  | **[Worktrees](docs/worktrees.md)** | `.slim/worktrees/` lane を使い、隔離された並列または高リスクなコーディング作業を行います |
package/README.ko-KR.md CHANGED
@@ -86,10 +86,37 @@ Install and configure oh-my-opencode-slim: https://raw.githubusercontent.com/alv
86
86
  bunx oh-my-opencode-slim@latest install
87
87
  ```
88
88
 
89
+ ### Master 브랜치에서 실행하기
90
+
91
+ 최신 코드를 사용하거나, 버그를 고치거나, 로컬에서 개발하고 기여하려면 이
92
+ 방식을 사용하세요:
93
+
94
+ ```bash
95
+ git clone https://github.com/alvinunreal/oh-my-opencode-slim.git ~/repos/oh-my-opencode-slim
96
+ cd ~/repos/oh-my-opencode-slim
97
+ bun install
98
+ bun run build
99
+ bun dist/cli/index.js install
100
+ ```
101
+
102
+ 인스톨러는 로컬 저장소 경로를 `~/.config/opencode/opencode.json`의
103
+ `plugin` 배열에 추가하므로, OpenCode는 해당 폴더에서 플러그인을 로드합니다.
104
+ 나중에 업데이트하려면:
105
+
106
+ ```bash
107
+ cd ~/repos/oh-my-opencode-slim
108
+ git pull
109
+ bun install
110
+ bun run build
111
+ ```
112
+
89
113
  ### 시작하기
90
114
 
91
115
  인스톨러는 OpenAI와 OpenCode Go 프리셋을 모두 생성하며, 기본적으로 OpenAI가 활성화됩니다.
92
116
 
117
+ > [!TIP]
118
+ > 모델과 에이전트는 자신의 워크플로에 맞게 자유롭게 조정하세요. 기본 프리셋은 시작점일 뿐이며, 이 플러그인은 깊은 유연성과 커스터마이징을 제공하도록 설계되었습니다.
119
+
93
120
  설치 중 OpenCode Go를 활성화하려면 `bunx oh-my-opencode-slim@latest install --preset=opencode-go`를 실행하거나, 설치 후 `~/.config/opencode/oh-my-opencode-slim.json`에서 기본 프리셋 이름을 변경하세요.
94
121
 
95
122
  그 다음:
@@ -112,7 +139,7 @@ bunx oh-my-opencode-slim@latest install
112
139
  > 자동 위임이 어떻게 동작하는지 이해하는 것을 **권장**합니다. **[Orchestrator 프롬프트](https://github.com/alvinunreal/oh-my-opencode-slim/blob/master/src/agents/orchestrator.ts#L28)** 에는 위임 규칙, 전문 에이전트 라우팅 로직, 메인 에이전트가 언제 서브에이전트로 작업을 넘겨야 하는지에 대한 임계값이 포함되어 있습니다. 수동으로 위임하려면 `@agentName <task>`로 서브에이전트를 호출하면 됩니다.
113
140
 
114
141
  > [!TIP]
115
- > 이제 백그라운드 에이전트가 기본 워크플로이므로 **[Multiplexer Integration](docs/multiplexer-integration.md)** 을 활성화하고 설정하는 것을 **강력히 권장**합니다. 각 에이전트를 전용 Tmux 또는 Zellij 창에서 자동으로 열어 주기 때문에, Orchestrator가 세션을 계속 조율하는 동안 전문 에이전트들의 작업을 실시간으로 따라볼 수 있습니다.
142
+ > 이제 백그라운드 에이전트가 기본 워크플로이므로 **[Multiplexer Integration](docs/multiplexer-integration.md)** 을 활성화하고 설정하는 것을 **강력히 권장**합니다. 각 에이전트를 전용 Tmux, Zellij, 또는 Herdr 창에서 자동으로 열어 주기 때문에, Orchestrator가 세션을 계속 조율하는 동안 전문 에이전트들의 작업을 실시간으로 따라볼 수 있습니다.
116
143
 
117
144
  기본 생성 설정에는 `openai`와 `opencode-go` 프리셋이 모두 포함되어 있습니다.
118
145
 
@@ -130,12 +157,11 @@ bunx oh-my-opencode-slim@latest install
130
157
  "fixer": { "model": "openai/gpt-5.5", "variant": "low", "skills": [], "mcps": [] }
131
158
  },
132
159
  "opencode-go": {
133
- "orchestrator": { "model": "opencode-go/glm-5.1", "skills": [ "*" ], "mcps": [ "*", "!context7" ] },
134
- "oracle": { "model": "opencode-go/deepseek-v4-pro", "variant": "max", "skills": ["simplify"], "mcps": [] },
135
- "council": { "model": "opencode-go/deepseek-v4-pro", "variant": "high", "skills": [], "mcps": [] },
136
- "librarian": { "model": "opencode-go/minimax-m2.7", "skills": [], "mcps": [ "websearch", "context7", "gh_grep" ] },
137
- "explorer": { "model": "opencode-go/minimax-m2.7", "skills": [], "mcps": [] },
138
- "designer": { "model": "opencode-go/kimi-k2.6", "variant": "medium", "skills": [], "mcps": [] },
160
+ "orchestrator": { "model": "opencode-go/glm-5.2", "skills": [ "*" ], "mcps": [ "*", "!context7" ] },
161
+ "oracle": { "model": "opencode-go/qwen3.7-max", "variant": "max", "skills": ["simplify"], "mcps": [] },
162
+ "librarian": { "model": "opencode-go/deepseek-v4-flash", "skills": [], "mcps": [ "websearch", "context7", "gh_grep" ] },
163
+ "explorer": { "model": "opencode-go/deepseek-v4-flash", "skills": [], "mcps": [] },
164
+ "designer": { "model": "opencode-go/kimi-k2.7-code", "variant": "medium", "skills": [], "mcps": [] },
139
165
  "fixer": { "model": "opencode-go/deepseek-v4-flash", "variant": "high", "skills": [], "mcps": [] }
140
166
  }
141
167
  }
@@ -173,12 +199,12 @@ ping all agents
173
199
 
174
200
  V2는 oh-my-opencode-slim을 스케줄러 중심의 멀티 에이전트 워크플로 시스템으로 바꿉니다. Orchestrator는 계획, 위임, 결과 조정, 검증에 집중하고, 전문가들은 각자의 lane에서 작업합니다.
175
201
 
176
- - **[백그라운드 에이전트](#백그라운드-에이전트)** Orchestrator가 전문가를 백그라운드 작업으로 디스패치하고, 작업/세션 ID를 추적하며, 완료 이벤트를 기다린 뒤 결과를 조정합니다.
177
- - **[Companion](#companion)** 선택 사항인 플로팅 데스크톱 창이 병렬 백그라운드 전문가를 포함해 현재 활성 에이전트를 보여줍니다.
178
- - **[Deepwork](#deepwork)** 대규모, 다중 파일, 위험도가 높거나 단계적인 코딩 작업을 위한 구조화된 워크플로입니다. 지속적인 계획 파일과 Oracle 리뷰 게이트를 사용합니다.
179
- - **[Reflect](#reflect)** 반복되는 작업 패턴을 돌아보고 재사용 가능한 skill, 에이전트, 명령, 설정 규칙, 프롬프트 규칙, 프로젝트 playbook을 제안합니다.
180
- - **[Worktrees](#worktrees)** 복잡하거나 위험하거나 병렬로 진행되는 작업을 위해 Git worktree를 안전 프로토콜이 있는 격리된 코딩 lane으로 관리합니다.
181
- - **[oh-my-opencode-slim Skill](#oh-my-opencode-slim-skill)** 모델, 프롬프트, 커스텀 에이전트, MCP 접근, 프리셋, 플러그인 동작을 안전하게 조정하는 번들 설정 skill입니다.
202
+ - **[백그라운드 에이전트](#백그라운드-에이전트)** - Orchestrator가 전문가를 백그라운드 작업으로 디스패치하고, 작업/세션 ID를 추적하며, 완료 이벤트를 기다린 뒤 결과를 조정합니다.
203
+ - **[Companion](#companion)** - 선택 사항인 플로팅 데스크톱 창이 병렬 백그라운드 전문가를 포함해 현재 활성 에이전트를 보여줍니다.
204
+ - **[Deepwork](#deepwork)** - 대규모, 다중 파일, 위험도가 높거나 단계적인 코딩 작업을 위한 구조화된 워크플로입니다. 지속적인 계획 파일과 Oracle 리뷰 게이트를 사용합니다.
205
+ - **[Reflect](#reflect)** - 반복되는 작업 패턴을 돌아보고 재사용 가능한 skill, 에이전트, 명령, 설정 규칙, 프롬프트 규칙, 프로젝트 playbook을 제안합니다.
206
+ - **[Worktrees](#worktrees)** - 복잡하거나 위험하거나 병렬로 진행되는 작업을 위해 Git worktree를 안전 프로토콜이 있는 격리된 코딩 lane으로 관리합니다.
207
+ - **[oh-my-opencode-slim Skill](#oh-my-opencode-slim-skill)** - 모델, 프롬프트, 커스텀 에이전트, MCP 접근, 프리셋, 플러그인 동작을 안전하게 조정하는 번들 설정 skill입니다.
182
208
 
183
209
  #### 백그라운드 에이전트
184
210
 
@@ -195,7 +221,7 @@ V2에서는 백그라운드 전문가가 기본 동작 모델입니다. Orchestr
195
221
  <p><i>왼쪽 아래의 시각적 companion.</i></p>
196
222
  </div>
197
223
 
198
- 대화형 설치 중 인스톨러는 Companion 활성화 여부를 묻고 기본값은 `yes`입니다. 자동화에서는 명시적으로 활성화할 수 있습니다.
224
+ 대화형 설치 중 인스톨러는 Companion 활성화 여부를 묻고 기본값은 `no`입니다. 자동화에서는 명시적으로 활성화할 수 있습니다.
199
225
 
200
226
  ```bash
201
227
  bunx oh-my-opencode-slim@latest install --companion=yes
@@ -413,7 +439,7 @@ Worktrees는 Git worktree를 `.slim/worktrees/<slug>/` 아래의 안전하고
413
439
  </tr>
414
440
  <tr>
415
441
  <td colspan="2">
416
- <b>기본 설정:</b> <code>Config-driven</code> Council 구성원은 <code>council.presets</code>에서 가져오고, Council 에이전트 모델은 일반 <code>council</code> 에이전트 설정에서 가져옵니다
442
+ <b>기본 설정:</b> <code>Config-driven</code> - Council 구성원은 <code>council.presets</code>에서 가져오고, Council 에이전트 모델은 일반 <code>council</code> 에이전트 설정에서 가져옵니다
417
443
  </td>
418
444
  </tr>
419
445
  <tr>
@@ -568,11 +594,11 @@ Worktrees는 Git worktree를 `.slim/worktrees/<slug>/` 아래의 안전하고
568
594
  </td>
569
595
  <td width="70%" valign="top">
570
596
 
571
- **읽기 전용 시각 분석** 이미지, 스크린샷, PDF, 다이어그램을 해석합니다. 원시 파일 바이트를 메인 컨텍스트 윈도우에 로드하지 않고, 구조화된 관찰 결과를 오케스트레이터에 반환합니다.
597
+ **읽기 전용 시각 분석** - 이미지, 스크린샷, PDF, 다이어그램을 해석합니다. 원시 파일 바이트를 메인 컨텍스트 윈도우에 로드하지 않고, 구조화된 관찰 결과를 오케스트레이터에 반환합니다.
572
598
 
573
599
  - 이미지, 스크린샷, 다이어그램 -> `read` 도구 (네이티브 이미지 지원)
574
600
  - PDF 및 바이너리 문서 -> `read` 도구 (텍스트 + 구조 추출)
575
- - **기본 비활성화** `"disabled_agents": []`로 설정하고 비전 지원 모델을 구성하여 활성화; `--preset=opencode-go`로 설치하면 `opencode-go/kimi-k2.6`으로 자동 활성화됩니다
601
+ - **기본 비활성화** - `"disabled_agents": []`로 설정하고 비전 지원 모델을 구성하여 활성화; `--preset=opencode-go`로 설치하면 `opencode-go/kimi-k2.6`으로 자동 활성화됩니다
576
602
 
577
603
  </td>
578
604
  </tr>
@@ -583,7 +609,7 @@ Worktrees는 Git worktree를 `.slim/worktrees/<slug>/` 아래의 안전하고
583
609
  </tr>
584
610
  <tr>
585
611
  <td colspan="2">
586
- <b>기본 모델:</b> <code>openai/gpt-5.4-mini</code> <i>비전 지원 모델을 구성하여 활성화</i>
612
+ <b>기본 모델:</b> <code>openai/gpt-5.4-mini</code> - <i>비전 지원 모델을 구성하여 활성화</i>
587
613
  </td>
588
614
  </tr>
589
615
  <tr>
@@ -608,7 +634,7 @@ Worktrees는 Git worktree를 `.slim/worktrees/<slug>/` 아래의 안전하고
608
634
  | **[Council](docs/council.md)** | `@council`로 여러 모델을 병렬 실행하고 하나의 답변으로 종합 |
609
635
  | **[Custom Agents](docs/configuration.md#custom-agents)** | 커스텀 프롬프트, 모델, MCP 접근, Orchestrator 위임 규칙으로 커스텀 전문 에이전트 정의 |
610
636
  | **[ACP Agents](docs/acp-agents.md)** | Claude Code ACP 또는 Gemini ACP 같은 외부 ACP 호환 에이전트를 위임 가능한 서브에이전트로 연결 |
611
- | **[Multiplexer Integration](docs/multiplexer-integration.md)** | Tmux 또는 Zellij 페인에서 에이전트 작업을 실시간으로 확인 |
637
+ | **[Multiplexer Integration](docs/multiplexer-integration.md)** | Tmux, Zellij, 또는 Herdr 페인에서 에이전트 작업을 실시간으로 확인 |
612
638
  | **[Codemap](docs/codemap.md)** | 계층형 코드맵을 생성하여 대규모 코드베이스를 빠르게 파악 |
613
639
  | **[Clonedeps](docs/clonedeps.md)** | 선택한 의존성 소스를 무시된 로컬 워크스페이스에 복제하여 검사 |
614
640
  | **[Worktrees](docs/worktrees.md)** | `.slim/worktrees/` lane을 사용해 격리된 병렬 또는 고위험 코딩 작업 수행 |
package/README.md CHANGED
@@ -83,10 +83,38 @@ Install and configure oh-my-opencode-slim: https://raw.githubusercontent.com/alv
83
83
  bunx oh-my-opencode-slim@latest install
84
84
  ```
85
85
 
86
+ ### Run from Master
87
+
88
+ Use this if you want the latest code, easier bug fixes, or a local setup for
89
+ development and contributions:
90
+
91
+ ```bash
92
+ git clone https://github.com/alvinunreal/oh-my-opencode-slim.git ~/repos/oh-my-opencode-slim
93
+ cd ~/repos/oh-my-opencode-slim
94
+ bun install
95
+ bun run build
96
+ bun dist/cli/index.js install
97
+ ```
98
+
99
+ The installer adds the local repo path to the `plugin` array in
100
+ `~/.config/opencode/opencode.json`, so OpenCode loads the plugin from that
101
+ folder. To update later:
102
+
103
+ ```bash
104
+ cd ~/repos/oh-my-opencode-slim
105
+ git pull
106
+ bun install
107
+ bun run build
108
+ ```
109
+
86
110
  ### Getting Started
87
111
 
88
112
  The installer generates both OpenAI and OpenCode Go presets, with OpenAI active by default.
89
113
 
114
+ > [!TIP]
115
+ > Tune the models and agents for your own workflow. The defaults are only a
116
+ > starting point; the plugin is designed for deep flexibility and customization.
117
+
90
118
  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.
91
119
 
92
120
  Then:
@@ -109,7 +137,7 @@ Then:
109
137
  > 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>`
110
138
 
111
139
  > [!TIP]
112
- > 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.
140
+ > 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, Zellij, or Herdr pane, so you can watch specialists work live while the Orchestrator continues coordinating the session.
113
141
 
114
142
  The default generated configuration includes both `openai` and `opencode-go` presets.
115
143
 
@@ -127,12 +155,11 @@ The default generated configuration includes both `openai` and `opencode-go` pre
127
155
  "fixer": { "model": "openai/gpt-5.5", "variant": "low", "skills": [], "mcps": [] }
128
156
  },
129
157
  "opencode-go": {
130
- "orchestrator": { "model": "opencode-go/glm-5.1", "skills": [ "*" ], "mcps": [ "*", "!context7" ] },
131
- "oracle": { "model": "opencode-go/deepseek-v4-pro", "variant": "max", "skills": ["simplify"], "mcps": [] },
132
- "council": { "model": "opencode-go/deepseek-v4-pro", "variant": "high", "skills": [], "mcps": [] },
133
- "librarian": { "model": "opencode-go/minimax-m2.7", "skills": [], "mcps": [ "websearch", "context7", "gh_grep" ] },
134
- "explorer": { "model": "opencode-go/minimax-m2.7", "skills": [], "mcps": [] },
135
- "designer": { "model": "opencode-go/kimi-k2.6", "variant": "medium", "skills": [], "mcps": [] },
158
+ "orchestrator": { "model": "opencode-go/glm-5.2", "skills": [ "*" ], "mcps": [ "*", "!context7" ] },
159
+ "oracle": { "model": "opencode-go/qwen3.7-max", "variant": "max", "skills": ["simplify"], "mcps": [] },
160
+ "librarian": { "model": "opencode-go/deepseek-v4-flash", "skills": [], "mcps": [ "websearch", "context7", "gh_grep" ] },
161
+ "explorer": { "model": "opencode-go/deepseek-v4-flash", "skills": [], "mcps": [] },
162
+ "designer": { "model": "opencode-go/kimi-k2.7-code", "variant": "medium", "skills": [], "mcps": [] },
136
163
  "fixer": { "model": "opencode-go/deepseek-v4-flash", "variant": "high", "skills": [], "mcps": [] }
137
164
  }
138
165
  }
@@ -143,18 +170,6 @@ The default generated configuration includes both `openai` and `opencode-go` pre
143
170
 
144
171
  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.
145
172
 
146
- ### Temporarily Disable the Plugin
147
-
148
- Set `OH_MY_OPENCODE_SLIM_DISABLE=1` when starting OpenCode to make the plugin
149
- return without registering agents, tools, MCPs, hooks, Companion, or the TUI
150
- sidebar:
151
-
152
- ```bash
153
- OH_MY_OPENCODE_SLIM_DISABLE=1 opencode
154
- ```
155
-
156
- Truthy values are `1`, `true`, `yes`, and `on`.
157
-
158
173
  ### ✅ Verify Your Setup
159
174
 
160
175
  After installation and authentication, verify all agents are configured and responding:
@@ -184,18 +199,18 @@ V2 turns oh-my-opencode-slim into a scheduler-first multi-agent workflow system.
184
199
  The Orchestrator stays focused on planning, delegation, reconciliation, and
185
200
  verification while specialists do the work in their own lanes.
186
201
 
187
- - **[Background agents](#background-agents)** the Orchestrator now dispatches
202
+ - **[Background agents](#background-agents)** - the Orchestrator now dispatches
188
203
  specialists as background tasks, tracks task/session IDs, waits for completion
189
204
  events, and reconciles results before continuing.
190
- - **[Companion](#companion)** an optional floating desktop window shows which
205
+ - **[Companion](#companion)** - an optional floating desktop window shows which
191
206
  agents are currently active, including parallel background specialists.
192
- - **[Deepwork](#deepwork)** a structured workflow for large, multi-file, risky,
207
+ - **[Deepwork](#deepwork)** - a structured workflow for large, multi-file, risky,
193
208
  or phased coding work using persistent plan files and Oracle review gates.
194
- - **[Reflect](#reflect)** reviews repeated work patterns and suggests reusable skills,
209
+ - **[Reflect](#reflect)** - reviews repeated work patterns and suggests reusable skills,
195
210
  agents, commands, config rules, prompt rules, or project playbooks.
196
- - **[Worktrees](#worktrees)** manages Git worktrees as isolated coding lanes
211
+ - **[Worktrees](#worktrees)** - manages Git worktrees as isolated coding lanes
197
212
  with safety protocols for complex, risky, or parallel tasks.
198
- - **[oh-my-opencode-slim skill](#oh-my-opencode-slim-skill)** a bundled
213
+ - **[oh-my-opencode-slim skill](#oh-my-opencode-slim-skill)** - a bundled
199
214
  configuration skill that helps tune models, prompts, custom agents, MCP access,
200
215
  presets, and plugin behavior safely.
201
216
 
@@ -220,7 +235,7 @@ background work is easier to follow at a glance.
220
235
  </div>
221
236
 
222
237
  During interactive install, the installer asks whether to enable Companion and
223
- defaults to `yes`. For automation, enable it explicitly with:
238
+ defaults to `no`. For automation, enable it explicitly with:
224
239
 
225
240
  ```bash
226
241
  bunx oh-my-opencode-slim@latest install --companion=yes
@@ -451,7 +466,7 @@ rules.
451
466
  </tr>
452
467
  <tr>
453
468
  <td colspan="2">
454
- <b>Default Setup:</b> <code>Config-driven</code> councillors come from <code>council.presets</code> and the Council agent model comes from your normal <code>council</code> agent config
469
+ <b>Default Setup:</b> <code>Config-driven</code> - councillors come from <code>council.presets</code> and the Council agent model comes from your normal <code>council</code> agent config
455
470
  </td>
456
471
  </tr>
457
472
  <tr>
@@ -606,11 +621,11 @@ rules.
606
621
  </td>
607
622
  <td width="70%" valign="top">
608
623
 
609
- **Read-only visual analysis** interprets images, screenshots, PDFs, and diagrams. Returns structured observations to the orchestrator without loading raw file bytes into the main context window.
624
+ **Read-only visual analysis** - interprets images, screenshots, PDFs, and diagrams. Returns structured observations to the orchestrator without loading raw file bytes into the main context window.
610
625
 
611
626
  - Images, screenshots, diagrams → `read` tool (native image support)
612
627
  - PDFs and binary documents → `read` tool (text + structure extraction)
613
- - **Disabled by default** enable with `"disabled_agents": []` and configure a vision-capable model; installing with `--preset=opencode-go` enables it with `opencode-go/kimi-k2.6`
628
+ - **Disabled by default** - enable with `"disabled_agents": []` and configure a vision-capable model; installing with `--preset=opencode-go` enables it with `opencode-go/kimi-k2.6`
614
629
 
615
630
  </td>
616
631
  </tr>
@@ -621,7 +636,7 @@ rules.
621
636
  </tr>
622
637
  <tr>
623
638
  <td colspan="2">
624
- <b>Default Model:</b> <code>openai/gpt-5.4-mini</code> <i>configure a vision-capable model to enable</i>
639
+ <b>Default Model:</b> <code>openai/gpt-5.4-mini</code> - <i>configure a vision-capable model to enable</i>
625
640
  </td>
626
641
  </tr>
627
642
  <tr>
@@ -646,7 +661,7 @@ Use this section as a map: start with installation, then jump to features, confi
646
661
  | **[Council](docs/council.md)** | Run multiple models in parallel and synthesize a single answer with `@council` |
647
662
  | **[Custom Agents](docs/configuration.md#custom-agents)** | Define your own specialists with custom prompts, models, MCP access, and Orchestrator delegation rules |
648
663
  | **[ACP Agents](docs/acp-agents.md)** | Connect external ACP-compatible agents such as Claude Code ACP or Gemini ACP as delegatable subagents |
649
- | **[Multiplexer Integration](docs/multiplexer-integration.md)** | Watch agents work live in Tmux or Zellij panes |
664
+ | **[Multiplexer Integration](docs/multiplexer-integration.md)** | Watch agents work live in Tmux, Zellij, or Herdr panes |
650
665
  | **[Codemap](docs/codemap.md)** | Generate hierarchical codemaps to understand large codebases faster |
651
666
  | **[Clonedeps](docs/clonedeps.md)** | Clone selected dependency source into an ignored local workspace for inspection |
652
667
  | **[Worktrees](docs/worktrees.md)** | Use `.slim/worktrees/` lanes for isolated parallel or risky coding work |
@@ -660,6 +675,7 @@ Use this section as a map: start with installation, then jump to features, confi
660
675
  |-----|----------------|
661
676
  | **[Installation Guide](docs/installation.md)** | Install the plugin, use CLI flags, reset config, and troubleshoot setup |
662
677
  | **[Configuration](docs/configuration.md)** | Config file locations, JSONC support, prompt overrides, and full option reference |
678
+ | **[Project Customization](docs/project-local-customization.md)** | Repository-specific custom agents, prompt overrides, per-agent skills, and precedence |
663
679
  | **[Background Orchestration](docs/background-orchestration.md)** | Scheduler-first orchestrator model built around native background subagents |
664
680
  | **[Maintainer Guide](docs/maintainers.md)** | Issue triage rules, label meanings, support routing, and repo maintenance workflow |
665
681
  | **[Skills](docs/skills.md)** | Bundled skills such as `simplify`, `codemap`, `clonedeps`, `deepwork`, `reflect`, `worktrees`, and `oh-my-opencode-slim` |
@@ -683,7 +699,7 @@ Use this section as a map: start with installation, then jump to features, confi
683
699
  <p><sub>Every merged contribution leaves a mark on the realm.</sub></p>
684
700
 
685
701
  <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
686
- [![All Contributors](https://img.shields.io/badge/all_contributors-66-orange.svg?style=flat-square)](#contributors-)
702
+ [![All Contributors](https://img.shields.io/badge/all_contributors-72-orange.svg?style=flat-square)](#contributors-)
687
703
  <!-- ALL-CONTRIBUTORS-BADGE:END -->
688
704
  </div>
689
705
 
@@ -782,6 +798,14 @@ Use this section as a map: start with installation, then jump to features, confi
782
798
  <td align="center" valign="top" width="16.66%"><a href="https://github.com/linze0721"><img src="https://avatars.githubusercontent.com/u/178997622?v=4?s=100" width="100px;" alt="萧瑟"/><br /><sub><b>萧瑟</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=linze0721" title="Code">💻</a></td>
783
799
  <td align="center" valign="top" width="16.66%"><a href="https://github.com/SisyphusZheng"><img src="https://avatars.githubusercontent.com/u/146103794?v=4?s=100" width="100px;" alt="Zhi"/><br /><sub><b>Zhi</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=SisyphusZheng" title="Code">💻</a></td>
784
800
  </tr>
801
+ <tr>
802
+ <td align="center" valign="top" width="16.66%"><a href="https://github.com/824156793"><img src="https://avatars.githubusercontent.com/u/19755784?v=4?s=100" width="100px;" alt="lilili"/><br /><sub><b>lilili</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=824156793" title="Code">💻</a></td>
803
+ <td align="center" valign="top" width="16.66%"><a href="http://mikehenke.com/"><img src="https://avatars.githubusercontent.com/u/119844?v=4?s=100" width="100px;" alt="Mike Henke"/><br /><sub><b>Mike Henke</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=mhenke" title="Code">💻</a></td>
804
+ <td align="center" valign="top" width="16.66%"><a href="https://github.com/imVinayPandya"><img src="https://avatars.githubusercontent.com/u/5011197?v=4?s=100" width="100px;" alt="Vinay Pandya"/><br /><sub><b>Vinay Pandya</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=imVinayPandya" title="Code">💻</a></td>
805
+ <td align="center" valign="top" width="16.66%"><a href="https://github.com/s-shank"><img src="https://avatars.githubusercontent.com/u/241541918?v=4?s=100" width="100px;" alt="Shank"/><br /><sub><b>Shank</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=s-shank" title="Code">💻</a></td>
806
+ <td align="center" valign="top" width="16.66%"><a href="https://rgutzen.github.io/"><img src="https://avatars.githubusercontent.com/u/16289604?v=4?s=100" width="100px;" alt="Robin Gutzen"/><br /><sub><b>Robin Gutzen</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=rgutzen" title="Code">💻</a></td>
807
+ <td align="center" valign="top" width="16.66%"><a href="https://github.com/dragon-Elec"><img src="https://avatars.githubusercontent.com/u/197374270?v=4?s=100" width="100px;" alt="Yash"/><br /><sub><b>Yash</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=dragon-Elec" title="Code">💻</a></td>
808
+ </tr>
785
809
  </tbody>
786
810
  </table>
787
811