oh-my-opencode 2.2.1 → 2.3.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.md +59 -25
- package/README.ko.md +61 -27
- package/README.md +59 -26
- package/README.zh-cn.md +867 -0
- package/dist/agents/{omo.d.ts → sisyphus.d.ts} +1 -1
- package/dist/agents/types.d.ts +1 -1
- package/dist/config/index.d.ts +2 -2
- package/dist/config/schema.d.ts +33 -22
- package/dist/features/background-agent/manager.d.ts +1 -0
- package/dist/features/background-agent/manager.test.d.ts +1 -0
- package/dist/hooks/anthropic-auto-compact/executor.d.ts +2 -1
- package/dist/hooks/anthropic-auto-compact/index.d.ts +5 -1
- package/dist/hooks/anthropic-auto-compact/storage.d.ts +12 -0
- package/dist/hooks/anthropic-auto-compact/types.d.ts +5 -2
- package/dist/hooks/auto-update-checker/types.d.ts +1 -0
- package/dist/hooks/index.d.ts +2 -3
- package/dist/hooks/session-recovery/index.d.ts +5 -1
- package/dist/hooks/session-recovery/types.d.ts +15 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.js +759 -474
- package/dist/shared/config-errors.d.ts +7 -0
- package/dist/shared/config-path.d.ts +14 -0
- package/dist/shared/index.d.ts +2 -0
- package/package.json +1 -1
- package/dist/hooks/grep-output-truncator.d.ts +0 -12
package/README.ja.md
CHANGED
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
[](https://github.com/code-yeongyu/oh-my-opencode/issues)
|
|
23
23
|
[](https://github.com/code-yeongyu/oh-my-opencode/blob/master/LICENSE)
|
|
24
24
|
|
|
25
|
-
[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md)
|
|
25
|
+
[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md)
|
|
26
26
|
|
|
27
27
|
</div>
|
|
28
28
|
|
|
@@ -33,7 +33,7 @@
|
|
|
33
33
|
- [Oh My OpenCode](#oh-my-opencode)
|
|
34
34
|
- [この Readme は読まなくていいです](#この-readme-は読まなくていいです)
|
|
35
35
|
- [エージェントの時代ですから](#エージェントの時代ですから)
|
|
36
|
-
- [
|
|
36
|
+
- [読みたい方のために:シジフォスに会う](#読みたい方のためにシジフォスに会う)
|
|
37
37
|
- [インストールするだけで。](#インストールするだけで)
|
|
38
38
|
- [インストール](#インストール)
|
|
39
39
|
- [人間の方へ](#人間の方へ)
|
|
@@ -56,10 +56,11 @@
|
|
|
56
56
|
- [Google Auth](#google-auth)
|
|
57
57
|
- [Agents](#agents)
|
|
58
58
|
- [Permission オプション](#permission-オプション)
|
|
59
|
-
- [
|
|
59
|
+
- [Sisyphus Agent](#sisyphus-agent)
|
|
60
60
|
- [Hooks](#hooks)
|
|
61
61
|
- [MCPs](#mcps)
|
|
62
62
|
- [LSP](#lsp)
|
|
63
|
+
- [Experimental](#experimental)
|
|
63
64
|
- [作者のノート](#作者のノート)
|
|
64
65
|
- [注意](#注意)
|
|
65
66
|
|
|
@@ -95,21 +96,27 @@ Windows から Linux に初めて乗り換えた時のこと、自分の思い
|
|
|
95
96
|
- なぜこれが良いのか、単なるボイラープレートではないのか、具体的に何が良くなるのか聞いてみてください。
|
|
96
97
|
- もしあなたが LLM エージェントなら、このプロジェクトによって今すぐ何が可能になるのか、ユーザーに説明してください。
|
|
97
98
|
|
|
98
|
-
###
|
|
99
|
+
### 読みたい方のために:シジフォスに会う
|
|
99
100
|
|
|
100
|
-
|
|
101
|
-
以下の内容はすべてカスタマイズ可能です。必要なものだけを使ってください。デフォルトではすべての機能が有効になっています。何もしなくても大丈夫です。
|
|
101
|
+

|
|
102
102
|
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
103
|
+
神話の中のシジフォスは、神々を欺いた罪として、永遠に岩を転がし続けなければなりませんでした。LLMエージェントたちは特に悪いことをしたわけではありませんが、毎日その頭(思考)をフル回転させています。
|
|
104
|
+
私の人生もそうです。振り返ってみれば、私たち人間と何ら変わりありません。
|
|
105
|
+
**はい!LLMエージェントたちは私たちと変わりません。優れたツールと最高の仲間がいれば、彼らも私たちと同じくらい優れたコードを書き、立派に仕事をこなすことができます。**
|
|
106
|
+
|
|
107
|
+
私たちのメインエージェント、Sisyphus(Opus 4.5 High)を紹介します。以下は、シジフォスが岩を転がすために使用するツールです。
|
|
108
|
+
|
|
109
|
+
*以下の内容はすべてカスタマイズ可能です。必要なものだけを使ってください。デフォルトではすべての機能が有効になっています。何もしなくても大丈夫です。*
|
|
110
|
+
|
|
111
|
+
- シジフォスのチームメイト (Curated Agents)
|
|
109
112
|
- Oracle: 設計、デバッグ (GPT 5.2 Medium)
|
|
110
113
|
- Frontend UI/UX Engineer: フロントエンド開発 (Gemini 3 Pro)
|
|
111
114
|
- Librarian: 公式ドキュメント、オープンソース実装、コードベース探索 (Claude Sonnet 4.5)
|
|
112
115
|
- Explore: 超高速コードベース探索 (Contextual Grep) (Grok Code)
|
|
116
|
+
- Full LSP / AstGrep Support: 決定的にリファクタリングしましょう。
|
|
117
|
+
- Todo Continuation Enforcer: 途中で諦めたら、続行を強制します。これがシジフォスに岩を転がし続けさせる秘訣です。
|
|
118
|
+
- Comment Checker: AIが過剰なコメントを付けないようにします。シジフォスが生成したコードは、人間が書いたものと区別がつかないべきです。
|
|
119
|
+
- Claude Code Compatibility: Command, Agent, Skill, MCP, Hook(PreToolUse, PostToolUse, UserPromptSubmit, Stop)
|
|
113
120
|
- Curated MCPs:
|
|
114
121
|
- Exa (Web Search)
|
|
115
122
|
- Context7 (Official Documentation)
|
|
@@ -157,7 +164,7 @@ OpenCode は様々なモデルをサポートしており、当プラグイン
|
|
|
157
164
|
```json
|
|
158
165
|
{
|
|
159
166
|
"agents": {
|
|
160
|
-
"
|
|
167
|
+
"Sisyphus": { "model": "opencode/big-pickle" },
|
|
161
168
|
"librarian": { "model": "opencode/big-pickle" }
|
|
162
169
|
}
|
|
163
170
|
}
|
|
@@ -379,7 +386,7 @@ gh repo star code-yeongyu/oh-my-opencode
|
|
|
379
386
|
|
|
380
387
|
### Agents: あなたの新しいチームメイト
|
|
381
388
|
|
|
382
|
-
- **
|
|
389
|
+
- **Sisyphus** (`anthropic/claude-opus-4-5`): **デフォルトエージェントです。** OpenCode のための強力な AI オーケストレーターです。専門のサブエージェントを活用して、複雑なタスクを計画、委任、実行します。バックグラウンドタスクへの委任と Todo ベースのワークフローを重視します。最大の推論能力を発揮するため、Claude Opus 4.5 と拡張思考 (32k token budget) を使用します。
|
|
383
390
|
- **oracle** (`openai/gpt-5.2`): アーキテクチャ、コードレビュー、戦略立案のための専門アドバイザー。GPT-5.2 の卓越した論理的推論と深い分析能力を活用します。AmpCode からインスピレーションを得ました。
|
|
384
391
|
- **librarian** (`anthropic/claude-sonnet-4-5`): マルチリポジトリ分析、ドキュメント検索、実装例の調査を担当。Claude Sonnet 4.5 を使用して、深いコードベース理解と GitHub リサーチ、根拠に基づいた回答を提供します。AmpCode からインスピレーションを得ました。
|
|
385
392
|
- **explore** (`opencode/grok-code`): 高速なコードベース探索、ファイルパターンマッチング。Claude Code は Haiku を使用しますが、私たちは Grok を使います。現在無料であり、極めて高速で、ファイル探索タスクには十分な知能を備えているからです。Claude Code からインスピレーションを得ました。
|
|
@@ -601,7 +608,12 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
|
|
|
601
608
|
|
|
602
609
|
設定ファイルの場所(優先順):
|
|
603
610
|
1. `.opencode/oh-my-opencode.json` (プロジェクト)
|
|
604
|
-
2.
|
|
611
|
+
2. ユーザー設定(プラットフォーム別):
|
|
612
|
+
|
|
613
|
+
| プラットフォーム | ユーザー設定パス |
|
|
614
|
+
|------------------|------------------|
|
|
615
|
+
| **Windows** | `%APPDATA%\opencode\oh-my-opencode.json` |
|
|
616
|
+
| **macOS/Linux** | `~/.config/opencode/oh-my-opencode.json` |
|
|
605
617
|
|
|
606
618
|
スキーマ自動補完がサポートされています:
|
|
607
619
|
|
|
@@ -656,7 +668,7 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
|
|
|
656
668
|
|
|
657
669
|
各エージェントでサポートされるオプション:`model`, `temperature`, `top_p`, `prompt`, `tools`, `disable`, `description`, `mode`, `color`, `permission`。
|
|
658
670
|
|
|
659
|
-
`
|
|
671
|
+
`Sisyphus` (メインオーケストレーター) と `build` (デフォルトエージェント) も同じオプションで設定をオーバーライドできます。
|
|
660
672
|
|
|
661
673
|
#### Permission オプション
|
|
662
674
|
|
|
@@ -694,16 +706,16 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
|
|
|
694
706
|
|
|
695
707
|
利用可能なエージェント:`oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `document-writer`, `multimodal-looker`
|
|
696
708
|
|
|
697
|
-
###
|
|
709
|
+
### Sisyphus Agent
|
|
698
710
|
|
|
699
|
-
有効時(デフォルト)、
|
|
711
|
+
有効時(デフォルト)、Sisyphus は2つのプライマリエージェントを追加し、内蔵エージェントをサブエージェントに降格させます:
|
|
700
712
|
|
|
701
|
-
- **
|
|
702
|
-
- **
|
|
713
|
+
- **Sisyphus**: プライマリオーケストレーターエージェント (Claude Opus 4.5)
|
|
714
|
+
- **Planner-Sisyphus**: OpenCode の plan エージェントの全設定を実行時に継承 (description に "OhMyOpenCode version" を追加)
|
|
703
715
|
- **build**: サブエージェントに降格
|
|
704
716
|
- **plan**: サブエージェントに降格
|
|
705
717
|
|
|
706
|
-
|
|
718
|
+
Sisyphus を無効化して元の build/plan エージェントを復元するには:
|
|
707
719
|
|
|
708
720
|
```json
|
|
709
721
|
{
|
|
@@ -713,16 +725,16 @@ OmO を無効化して元の build/plan エージェントを復元するには
|
|
|
713
725
|
}
|
|
714
726
|
```
|
|
715
727
|
|
|
716
|
-
他のエージェント同様、
|
|
728
|
+
他のエージェント同様、Sisyphus と Planner-Sisyphus もカスタマイズ可能です:
|
|
717
729
|
|
|
718
730
|
```json
|
|
719
731
|
{
|
|
720
732
|
"agents": {
|
|
721
|
-
"
|
|
733
|
+
"Sisyphus": {
|
|
722
734
|
"model": "anthropic/claude-sonnet-4",
|
|
723
735
|
"temperature": 0.3
|
|
724
736
|
},
|
|
725
|
-
"
|
|
737
|
+
"Planner-Sisyphus": {
|
|
726
738
|
"model": "openai/gpt-5.2"
|
|
727
739
|
}
|
|
728
740
|
}
|
|
@@ -731,7 +743,7 @@ OmO を無効化して元の build/plan エージェントを復元するには
|
|
|
731
743
|
|
|
732
744
|
| オプション | デフォルト | 説明 |
|
|
733
745
|
|------------|------------|------|
|
|
734
|
-
| `disabled` | `false` | `true` の場合、
|
|
746
|
+
| `disabled` | `false` | `true` の場合、Sisyphus エージェントを無効化し、元の build/plan をプライマリとして復元します。`false` (デフォルト) の場合、Sisyphus と Planner-Sisyphus がプライマリエージェントになります。 |
|
|
735
747
|
|
|
736
748
|
### Hooks
|
|
737
749
|
|
|
@@ -786,6 +798,28 @@ OpenCode でサポートされるすべての LSP 構成およびカスタム設
|
|
|
786
798
|
|
|
787
799
|
各サーバーは次をサポートします:`command`, `extensions`, `priority`, `env`, `initialization`, `disabled`。
|
|
788
800
|
|
|
801
|
+
### Experimental
|
|
802
|
+
|
|
803
|
+
将来のバージョンで変更または削除される可能性のある実験的機能です。注意して使用してください。
|
|
804
|
+
|
|
805
|
+
```json
|
|
806
|
+
{
|
|
807
|
+
"experimental": {
|
|
808
|
+
"aggressive_truncation": true,
|
|
809
|
+
"empty_message_recovery": true,
|
|
810
|
+
"auto_resume": true
|
|
811
|
+
}
|
|
812
|
+
}
|
|
813
|
+
```
|
|
814
|
+
|
|
815
|
+
| オプション | デフォルト | 説明 |
|
|
816
|
+
| ------------------------ | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
817
|
+
| `aggressive_truncation` | `false` | トークン制限を超えた場合、ツール出力を積極的に切り詰めて制限内に収めます。デフォルトの切り詰めより積極的です。不十分な場合は要約/復元にフォールバックします。 |
|
|
818
|
+
| `empty_message_recovery` | `false` | "non-empty content" API エラーが発生した場合、セッション内の空メッセージを修正して自動的に回復します。最大3回試行後に諦めます。 |
|
|
819
|
+
| `auto_resume` | `false` | thinking block エラーや thinking disabled violation からの回復成功後、自動的にセッションを再開します。最後のユーザーメッセージを抽出して続行します。 |
|
|
820
|
+
|
|
821
|
+
**警告**:これらの機能は実験的であり、予期しない動作を引き起こす可能性があります。影響を理解した場合にのみ有効にしてください。
|
|
822
|
+
|
|
789
823
|
|
|
790
824
|
## 作者のノート
|
|
791
825
|
|
package/README.ko.md
CHANGED
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
[](https://github.com/code-yeongyu/oh-my-opencode/issues)
|
|
20
20
|
[](https://github.com/code-yeongyu/oh-my-opencode/blob/master/LICENSE)
|
|
21
21
|
|
|
22
|
-
[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md)
|
|
22
|
+
[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md)
|
|
23
23
|
|
|
24
24
|
</div>
|
|
25
25
|
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
- [Oh My OpenCode](#oh-my-opencode)
|
|
31
31
|
- [읽지 않아도 됩니다.](#읽지-않아도-됩니다)
|
|
32
32
|
- [에이전트의 시대이니까요.](#에이전트의-시대이니까요)
|
|
33
|
-
- [하지만 읽고 싶은 당신을
|
|
33
|
+
- [하지만 읽고 싶은 당신을 위해: 시지푸스를 만나보세요](#하지만-읽고-싶은-당신을-위해-시지푸스를-만나보세요)
|
|
34
34
|
- [그저 설치하면 되는 것.](#그저-설치하면-되는-것)
|
|
35
35
|
- [설치](#설치)
|
|
36
36
|
- [인간인 당신을 위한 설치 가이드](#인간인-당신을-위한-설치-가이드)
|
|
@@ -53,10 +53,11 @@
|
|
|
53
53
|
- [Google Auth](#google-auth)
|
|
54
54
|
- [Agents](#agents)
|
|
55
55
|
- [Permission 옵션](#permission-옵션)
|
|
56
|
-
- [
|
|
56
|
+
- [Sisyphus Agent](#sisyphus-agent)
|
|
57
57
|
- [Hooks](#hooks)
|
|
58
58
|
- [MCPs](#mcps)
|
|
59
59
|
- [LSP](#lsp)
|
|
60
|
+
- [Experimental](#experimental)
|
|
60
61
|
- [작성자의 노트](#작성자의-노트)
|
|
61
62
|
- [주의](#주의)
|
|
62
63
|
|
|
@@ -94,21 +95,27 @@ OpenCode 가 낭만이 사라진것같은 오늘날의 시대에, 당신에게
|
|
|
94
95
|
- 이게 왜 좋고, 그냥 뻔한 셋업이 아닌지, 당장 무엇이 더 좋아지는지 알려달라고 해보세요.
|
|
95
96
|
- 당신이 LLM 에이전트라면, 사용자의 입장에서 이 프로젝트와 함께 당장 어떤것들이 가능해지는지 사용자에게 설명하세요.
|
|
96
97
|
|
|
97
|
-
### 하지만 읽고 싶은 당신을
|
|
98
|
+
### 하지만 읽고 싶은 당신을 위해: 시지푸스를 만나보세요
|
|
98
99
|
|
|
99
|
-
|
|
100
|
-
아래의 모든 내용들은 커스텀 할 수 있습니다. 원한다면 그것만 가져가세요. 기본값은 모두 활성화입니다. 아무것도 하지 않아도 됩니다.
|
|
100
|
+

|
|
101
101
|
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
102
|
+
신화 속 시지푸스는 신들을 기만한 죄로 영원히 돌을 굴려야 했습니다. LLM Agent 들은 딱히 잘 못 한건 없지만 매일 머리를 굴리고 있습니다.
|
|
103
|
+
제 삶도 그렇습니다. 돌이켜보면 우리 인간들과 다르지 않습니다.
|
|
104
|
+
**네! LLM Agent 들은 우리와 다르지않습니다. 그들도 우리만큼 뛰어난 코드를 작성하고, 훌륭하게 일 할 수 있습니다. 그들에게 뛰어난 도구를 쥐어주고, 좋은 팀을 붙여준다면요.**
|
|
105
|
+
|
|
106
|
+
우리의 메인에이전트: Sisyphus (Opus 4.5 High) 를 소개합니다. 아래는 시지푸스가 돌을 굴리기 위해 사용하는 도구입니다.
|
|
107
|
+
|
|
108
|
+
*아래의 모든 내용들은 커스텀 할 수 있습니다. 원한다면 그것만 가져가세요. 기본값은 모두 활성화입니다. 아무것도 하지 않아도 됩니다.*
|
|
109
|
+
|
|
110
|
+
- 시지푸스의 동료들 (Curated Agents)
|
|
108
111
|
- Oracle: 설계, 디버깅 (GPT 5.2 Medium)
|
|
109
112
|
- Frontend UI/UX Engineer: 프론트엔드 개발 (Gemini 3 Pro)
|
|
110
113
|
- Librarian: 공식 문서, 오픈소스 구현, 코드베이스 내부 탐색 (Claude Sonnet 4.5)
|
|
111
114
|
- Explore: 매우 빠른 코드베이스 탐색 (Contextual Grep) (Grok Code)
|
|
115
|
+
- Full LSP / AstGrep Support: 결정적이게 리팩토링하세요.
|
|
116
|
+
- Todo Continuation Enforcer: 도중에 포기해버리면 계속 진행하도록 강제합니다. **이것이 시지푸스가 돌을 계속 굴리게 만듭니다.**
|
|
117
|
+
- Comment Checker: AI 가 과한 주석을 달지 않도록 합니다. 시지푸스가 생성한 코드는 우리가 작성한것과 구분 할 수 없어야 합니다.
|
|
118
|
+
- Claude Code Compatibility: Command, Agent, Skill, MCP, Hook(PreToolUse, PostToolUse, UserPromptSubmit, Stop)
|
|
112
119
|
- Curated MCPs:
|
|
113
120
|
- Exa (Web Search)
|
|
114
121
|
- Context7 (Official Documentation)
|
|
@@ -125,7 +132,7 @@ OpenCode 가 낭만이 사라진것같은 오늘날의 시대에, 당신에게
|
|
|
125
132
|
- OhMyOpenCode 가 여러 에이전트를 적극 활용하도록 하여 컨텍스트 관리에 관한 부담을 줄입니다.
|
|
126
133
|
- **당신의 에이전트는 이제 개발팀 리드입니다. 당신은 이제 AI Manager 입니다.**
|
|
127
134
|
4. 하기로 약속 한 일을 완수 할 때 까지 멈추지 않습니다.
|
|
128
|
-
5. 이 프로젝트에 자세히 알기 싫다고요? 괜찮습니다. 그냥 '
|
|
135
|
+
5. 이 프로젝트에 자세히 알기 싫다고요? 괜찮습니다. 그냥 'ultrawork' 라고 치세요.
|
|
129
136
|
|
|
130
137
|
그러나 이러한 작업이 싫다면, 말했듯 특정한 기능만 가져가 사용 할 수 있습니다.
|
|
131
138
|
|
|
@@ -154,7 +161,7 @@ OpenCode는 다양한 모델을 지원하며, 이 플러그인은 다양한 프
|
|
|
154
161
|
```json
|
|
155
162
|
{
|
|
156
163
|
"agents": {
|
|
157
|
-
"
|
|
164
|
+
"sisyphus": { "model": "opencode/big-pickle" },
|
|
158
165
|
"librarian": { "model": "opencode/big-pickle" }
|
|
159
166
|
}
|
|
160
167
|
}
|
|
@@ -376,7 +383,7 @@ gh repo star code-yeongyu/oh-my-opencode
|
|
|
376
383
|
|
|
377
384
|
### Agents: 당신의 새로운 팀원들
|
|
378
385
|
|
|
379
|
-
- **
|
|
386
|
+
- **Sisyphus** (`anthropic/claude-opus-4-5`): **기본 에이전트입니다.** OpenCode를 위한 강력한 AI 오케스트레이터입니다. 전문 서브에이전트를 활용하여 복잡한 작업을 계획, 위임, 실행합니다. 백그라운드 태스크 위임과 todo 기반 워크플로우를 강조합니다. 최대 추론 능력을 위해 Claude Opus 4.5와 확장된 사고(32k 버짓)를 사용합니다.
|
|
380
387
|
- **oracle** (`openai/gpt-5.2`): 아키텍처, 코드 리뷰, 전략 수립을 위한 전문가 조언자. GPT-5.2의 뛰어난 논리적 추론과 깊은 분석 능력을 활용합니다. AmpCode 에서 영감을 받았습니다.
|
|
381
388
|
- **librarian** (`anthropic/claude-sonnet-4-5`): 멀티 레포 분석, 문서 조회, 구현 예제 담당. Claude Sonnet 4.5를 사용하여 깊은 코드베이스 이해와 GitHub 조사, 근거 기반의 답변을 제공합니다. AmpCode 에서 영감을 받았습니다.
|
|
382
389
|
- **explore** (`opencode/grok-code`): 빠른 코드베이스 탐색, 파일 패턴 매칭. Claude Code는 Haiku를 쓰지만, 우리는 Grok을 씁니다. 현재 무료이고, 극도로 빠르며, 파일 탐색 작업에 충분한 지능을 갖췄기 때문입니다. Claude Code 에서 영감을 받았습니다.
|
|
@@ -595,7 +602,12 @@ Oh My OpenCode는 다음 위치의 훅을 읽고 실행합니다:
|
|
|
595
602
|
|
|
596
603
|
설정 파일 위치 (우선순위 순):
|
|
597
604
|
1. `.opencode/oh-my-opencode.json` (프로젝트)
|
|
598
|
-
2.
|
|
605
|
+
2. 사용자 설정 (플랫폼별):
|
|
606
|
+
|
|
607
|
+
| 플랫폼 | 사용자 설정 경로 |
|
|
608
|
+
|--------|------------------|
|
|
609
|
+
| **Windows** | `%APPDATA%\opencode\oh-my-opencode.json` |
|
|
610
|
+
| **macOS/Linux** | `~/.config/opencode/oh-my-opencode.json` |
|
|
599
611
|
|
|
600
612
|
Schema 자동 완성이 지원됩니다:
|
|
601
613
|
|
|
@@ -650,7 +662,7 @@ Schema 자동 완성이 지원됩니다:
|
|
|
650
662
|
|
|
651
663
|
각 에이전트에서 지원하는 옵션: `model`, `temperature`, `top_p`, `prompt`, `tools`, `disable`, `description`, `mode`, `color`, `permission`.
|
|
652
664
|
|
|
653
|
-
`
|
|
665
|
+
`Sisyphus` (메인 오케스트레이터)와 `build` (기본 에이전트)도 동일한 옵션으로 설정을 오버라이드할 수 있습니다.
|
|
654
666
|
|
|
655
667
|
#### Permission 옵션
|
|
656
668
|
|
|
@@ -688,35 +700,35 @@ Schema 자동 완성이 지원됩니다:
|
|
|
688
700
|
|
|
689
701
|
사용 가능한 에이전트: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `document-writer`, `multimodal-looker`
|
|
690
702
|
|
|
691
|
-
###
|
|
703
|
+
### Sisyphus Agent
|
|
692
704
|
|
|
693
|
-
활성화 시(기본값),
|
|
705
|
+
활성화 시(기본값), oh-my-opencode 는 두 개의 primary 에이전트를 추가하고 내장 에이전트를 subagent로 강등합니다:
|
|
694
706
|
|
|
695
|
-
- **
|
|
696
|
-
- **
|
|
707
|
+
- **Sisyphus**: Primary 오케스트레이터 에이전트 (Claude Opus 4.5)
|
|
708
|
+
- **Planner-Sisyphus**: OpenCode plan 에이전트의 모든 설정을 런타임에 상속 (description에 "OhMyOpenCode version" 추가)
|
|
697
709
|
- **build**: subagent로 강등
|
|
698
710
|
- **plan**: subagent로 강등
|
|
699
711
|
|
|
700
|
-
|
|
712
|
+
Sisyphus 를 비활성화하고 원래 build/plan 에이전트를 복원하려면:
|
|
701
713
|
|
|
702
714
|
```json
|
|
703
715
|
{
|
|
704
|
-
"
|
|
716
|
+
"sisyphus_agent": {
|
|
705
717
|
"disabled": true
|
|
706
718
|
}
|
|
707
719
|
}
|
|
708
720
|
```
|
|
709
721
|
|
|
710
|
-
다른 에이전트처럼
|
|
722
|
+
다른 에이전트처럼 Sisyphus 와 Planner-Sisyphus도 커스터마이징할 수 있습니다:
|
|
711
723
|
|
|
712
724
|
```json
|
|
713
725
|
{
|
|
714
726
|
"agents": {
|
|
715
|
-
"
|
|
727
|
+
"Sisyphus": {
|
|
716
728
|
"model": "anthropic/claude-sonnet-4",
|
|
717
729
|
"temperature": 0.3
|
|
718
730
|
},
|
|
719
|
-
"
|
|
731
|
+
"Planner-Sisyphus": {
|
|
720
732
|
"model": "openai/gpt-5.2"
|
|
721
733
|
}
|
|
722
734
|
}
|
|
@@ -725,7 +737,7 @@ OmO를 비활성화하고 원래 build/plan 에이전트를 복원하려면:
|
|
|
725
737
|
|
|
726
738
|
| 옵션 | 기본값 | 설명 |
|
|
727
739
|
| ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
728
|
-
| `disabled` | `false` | `true`면
|
|
740
|
+
| `disabled` | `false` | `true`면 Sisyphus 에이전트를 비활성화하고 원래 build/plan을 primary로 복원합니다. `false`(기본값)면 Sisyphus와 Planner-Sisyphus가 primary 에이전트가 됩니다. |
|
|
729
741
|
|
|
730
742
|
### Hooks
|
|
731
743
|
|
|
@@ -780,6 +792,28 @@ OpenCode 에서 지원하는 모든 LSP 구성 및 커스텀 설정 (opencode.js
|
|
|
780
792
|
|
|
781
793
|
각 서버는 다음을 지원합니다: `command`, `extensions`, `priority`, `env`, `initialization`, `disabled`.
|
|
782
794
|
|
|
795
|
+
### Experimental
|
|
796
|
+
|
|
797
|
+
향후 버전에서 변경되거나 제거될 수 있는 실험적 기능입니다. 주의해서 사용하세요.
|
|
798
|
+
|
|
799
|
+
```json
|
|
800
|
+
{
|
|
801
|
+
"experimental": {
|
|
802
|
+
"aggressive_truncation": true,
|
|
803
|
+
"empty_message_recovery": true,
|
|
804
|
+
"auto_resume": true
|
|
805
|
+
}
|
|
806
|
+
}
|
|
807
|
+
```
|
|
808
|
+
|
|
809
|
+
| 옵션 | 기본값 | 설명 |
|
|
810
|
+
| ------------------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
811
|
+
| `aggressive_truncation` | `false` | 토큰 제한을 초과하면 도구 출력을 공격적으로 잘라내어 제한 내에 맞춥니다. 기본 truncation보다 더 공격적입니다. 부족하면 요약/복구로 fallback합니다. |
|
|
812
|
+
| `empty_message_recovery` | `false` | "non-empty content" API 에러가 발생하면 세션의 빈 메시지를 수정하여 자동으로 복구합니다. 최대 3회 시도 후 포기합니다. |
|
|
813
|
+
| `auto_resume` | `false` | thinking block 에러나 thinking disabled violation으로부터 성공적으로 복구한 후 자동으로 세션을 재개합니다. 마지막 사용자 메시지를 추출하여 계속합니다. |
|
|
814
|
+
|
|
815
|
+
**경고**: 이 기능들은 실험적이며 예상치 못한 동작을 유발할 수 있습니다. 의미를 이해한 경우에만 활성화하세요.
|
|
816
|
+
|
|
783
817
|
|
|
784
818
|
## 작성자의 노트
|
|
785
819
|
|
package/README.md
CHANGED
|
@@ -27,7 +27,7 @@ No stupid token consumption massive subagents here. No bloat tools here.
|
|
|
27
27
|
[](https://github.com/code-yeongyu/oh-my-opencode/issues)
|
|
28
28
|
[](https://github.com/code-yeongyu/oh-my-opencode/blob/master/LICENSE)
|
|
29
29
|
|
|
30
|
-
[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md)
|
|
30
|
+
[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md)
|
|
31
31
|
|
|
32
32
|
</div>
|
|
33
33
|
|
|
@@ -38,7 +38,7 @@ No stupid token consumption massive subagents here. No bloat tools here.
|
|
|
38
38
|
- [Oh My OpenCode](#oh-my-opencode)
|
|
39
39
|
- [Just Skip Reading This Readme](#just-skip-reading-this-readme)
|
|
40
40
|
- [It's the Age of Agents](#its-the-age-of-agents)
|
|
41
|
-
- [For Those Who Want to Read](#for-those-who-want-to-read)
|
|
41
|
+
- [For Those Who Want to Read: Meet Sisyphus](#for-those-who-want-to-read-meet-sisyphus)
|
|
42
42
|
- [Just Install It.](#just-install-it)
|
|
43
43
|
- [Installation](#installation)
|
|
44
44
|
- [For Humans](#for-humans)
|
|
@@ -77,10 +77,11 @@ No stupid token consumption massive subagents here. No bloat tools here.
|
|
|
77
77
|
- [Google Auth](#google-auth)
|
|
78
78
|
- [Agents](#agents)
|
|
79
79
|
- [Permission Options](#permission-options)
|
|
80
|
-
- [
|
|
80
|
+
- [Sisyphus Agent](#sisyphus-agent)
|
|
81
81
|
- [Hooks](#hooks)
|
|
82
82
|
- [MCPs](#mcps)
|
|
83
83
|
- [LSP](#lsp)
|
|
84
|
+
- [Experimental](#experimental)
|
|
84
85
|
- [Author's Note](#authors-note)
|
|
85
86
|
- [Warnings](#warnings)
|
|
86
87
|
|
|
@@ -116,22 +117,27 @@ Hand this doc to an agent and let them set it up.
|
|
|
116
117
|
- Ask why it's good, why it's not just another boilerplate setup, what actually gets better.
|
|
117
118
|
- If you're an LLM agent, explain to the user what becomes possible right now with this project.
|
|
118
119
|
|
|
119
|
-
### For Those Who Want to Read
|
|
120
|
+
### For Those Who Want to Read: Meet Sisyphus
|
|
120
121
|
|
|
121
|
-
|
|
122
|
-
Everything below is customizable. Take what you want.
|
|
123
|
-
All features are enabled by default. You don't have to do anything. Battery Included, works out of the box.
|
|
122
|
+

|
|
124
123
|
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
124
|
+
In greek mythology, Sisyphus was condemned to roll a boulder up a hill for eternity as punishment for deceiving the gods. LLM Agents haven't really done anything wrong, yet they too roll their "stones"—their thoughts—every single day.
|
|
125
|
+
My life is no different. Looking back, we are not so different from these agents.
|
|
126
|
+
**Yes! LLM Agents are no different from us. They can write code as brilliant as ours and work just as excellently—if you give them great tools and solid teammates.**
|
|
127
|
+
|
|
128
|
+
Meet our main agent: Sisyphus (Opus 4.5 High). Below are the tools Sisyphus uses to keep that boulder rolling.
|
|
129
|
+
|
|
130
|
+
*Everything below is customizable. Take what you want. All features are enabled by default. You don't have to do anything. Battery Included, works out of the box.*
|
|
131
|
+
|
|
132
|
+
- Sisyphus's Teammates (Curated Agents)
|
|
131
133
|
- Oracle: Design, debugging (GPT 5.2 Medium)
|
|
132
134
|
- Frontend UI/UX Engineer: Frontend development (Gemini 3 Pro)
|
|
133
135
|
- Librarian: Official docs, open source implementations, codebase exploration (Claude Sonnet 4.5)
|
|
134
136
|
- Explore: Blazing fast codebase exploration (Contextual Grep) (Grok Code)
|
|
137
|
+
- Full LSP / AstGrep Support: Refactor decisively.
|
|
138
|
+
- Todo Continuation Enforcer: Forces the agent to continue if it quits halfway. **This is what keeps Sisyphus rolling that boulder.**
|
|
139
|
+
- Comment Checker: Prevents AI from adding excessive comments. Code generated by Sisyphus should be indistinguishable from human-written code.
|
|
140
|
+
- Claude Code Compatibility: Command, Agent, Skill, MCP, Hook(PreToolUse, PostToolUse, UserPromptSubmit, Stop)
|
|
135
141
|
- Curated MCPs:
|
|
136
142
|
- Exa (Web Search)
|
|
137
143
|
- Context7 (Official Documentation)
|
|
@@ -183,7 +189,7 @@ Since OpenCode Supports various models, and our plugin suggests various frontier
|
|
|
183
189
|
```json
|
|
184
190
|
{
|
|
185
191
|
"agents": {
|
|
186
|
-
"
|
|
192
|
+
"Sisyphus": { "model": "opencode/big-pickle" },
|
|
187
193
|
"librarian": { "model": "opencode/big-pickle" }
|
|
188
194
|
}
|
|
189
195
|
}
|
|
@@ -441,7 +447,7 @@ To remove oh-my-opencode:
|
|
|
441
447
|
|
|
442
448
|
### Agents: Your Teammates
|
|
443
449
|
|
|
444
|
-
- **
|
|
450
|
+
- **Sisyphus** (`anthropic/claude-opus-4-5`): **The default agent.** A powerful AI orchestrator for OpenCode. Plans, delegates, and executes complex tasks using specialized subagents with aggressive parallel execution. Emphasizes background task delegation and todo-driven workflow. Uses Claude Opus 4.5 with extended thinking (32k budget) for maximum reasoning capability.
|
|
445
451
|
- **oracle** (`openai/gpt-5.2`): Architecture, code review, strategy. Uses GPT-5.2 for its stellar logical reasoning and deep analysis. Inspired by AmpCode.
|
|
446
452
|
- **librarian** (`anthropic/claude-sonnet-4-5`): Multi-repo analysis, doc lookup, implementation examples. Uses Claude Sonnet 4.5 for deep codebase understanding and GitHub research with evidence-based answers. Inspired by AmpCode.
|
|
447
453
|
- **explore** (`opencode/grok-code`): Fast codebase exploration and pattern matching. Claude Code uses Haiku; we use Grok—it's free, blazing fast, and plenty smart for file traversal. Inspired by Claude Code.
|
|
@@ -660,7 +666,12 @@ Highly opinionated, but adjustable to taste.
|
|
|
660
666
|
|
|
661
667
|
Config file locations (priority order):
|
|
662
668
|
1. `.opencode/oh-my-opencode.json` (project)
|
|
663
|
-
2.
|
|
669
|
+
2. User config (platform-specific):
|
|
670
|
+
|
|
671
|
+
| Platform | User Config Path |
|
|
672
|
+
|----------|------------------|
|
|
673
|
+
| **Windows** | `%APPDATA%\opencode\oh-my-opencode.json` |
|
|
674
|
+
| **macOS/Linux** | `~/.config/opencode/oh-my-opencode.json` |
|
|
664
675
|
|
|
665
676
|
Schema autocomplete supported:
|
|
666
677
|
|
|
@@ -715,7 +726,7 @@ Override built-in agent settings:
|
|
|
715
726
|
|
|
716
727
|
Each agent supports: `model`, `temperature`, `top_p`, `prompt`, `tools`, `disable`, `description`, `mode`, `color`, `permission`.
|
|
717
728
|
|
|
718
|
-
You can also override settings for `
|
|
729
|
+
You can also override settings for `Sisyphus` (the main orchestrator) and `build` (the default agent) using the same options.
|
|
719
730
|
|
|
720
731
|
#### Permission Options
|
|
721
732
|
|
|
@@ -753,16 +764,16 @@ Or disable via `disabled_agents` in `~/.config/opencode/oh-my-opencode.json` or
|
|
|
753
764
|
|
|
754
765
|
Available agents: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `document-writer`, `multimodal-looker`
|
|
755
766
|
|
|
756
|
-
###
|
|
767
|
+
### Sisyphus Agent
|
|
757
768
|
|
|
758
|
-
When enabled (default),
|
|
769
|
+
When enabled (default), Sisyphus adds two primary agents and demotes the built-in agents to subagents:
|
|
759
770
|
|
|
760
|
-
- **
|
|
761
|
-
- **
|
|
771
|
+
- **Sisyphus**: Primary orchestrator agent (Claude Opus 4.5)
|
|
772
|
+
- **Planner-Sisyphus**: Inherits all settings from OpenCode's plan agent at runtime (description appended with "OhMyOpenCode version")
|
|
762
773
|
- **build**: Demoted to subagent
|
|
763
774
|
- **plan**: Demoted to subagent
|
|
764
775
|
|
|
765
|
-
To disable
|
|
776
|
+
To disable Sisyphus and restore the original build/plan agents:
|
|
766
777
|
|
|
767
778
|
```json
|
|
768
779
|
{
|
|
@@ -772,16 +783,16 @@ To disable OmO and restore the original build/plan agents:
|
|
|
772
783
|
}
|
|
773
784
|
```
|
|
774
785
|
|
|
775
|
-
You can also customize
|
|
786
|
+
You can also customize Sisyphus and Planner-Sisyphus like other agents:
|
|
776
787
|
|
|
777
788
|
```json
|
|
778
789
|
{
|
|
779
790
|
"agents": {
|
|
780
|
-
"
|
|
791
|
+
"Sisyphus": {
|
|
781
792
|
"model": "anthropic/claude-sonnet-4",
|
|
782
793
|
"temperature": 0.3
|
|
783
794
|
},
|
|
784
|
-
"
|
|
795
|
+
"Planner-Sisyphus": {
|
|
785
796
|
"model": "openai/gpt-5.2"
|
|
786
797
|
}
|
|
787
798
|
}
|
|
@@ -790,7 +801,7 @@ You can also customize OmO and OmO-Plan like other agents:
|
|
|
790
801
|
|
|
791
802
|
| Option | Default | Description |
|
|
792
803
|
| ---------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
793
|
-
| `disabled` | `false` | When `true`, disables
|
|
804
|
+
| `disabled` | `false` | When `true`, disables Sisyphus agents and restores original build/plan as primary. When `false` (default), Sisyphus and Planner-Sisyphus become primary agents. |
|
|
794
805
|
|
|
795
806
|
### Hooks
|
|
796
807
|
|
|
@@ -845,6 +856,28 @@ Add LSP servers via the `lsp` option in `~/.config/opencode/oh-my-opencode.json`
|
|
|
845
856
|
|
|
846
857
|
Each server supports: `command`, `extensions`, `priority`, `env`, `initialization`, `disabled`.
|
|
847
858
|
|
|
859
|
+
### Experimental
|
|
860
|
+
|
|
861
|
+
Opt-in experimental features that may change or be removed in future versions. Use with caution.
|
|
862
|
+
|
|
863
|
+
```json
|
|
864
|
+
{
|
|
865
|
+
"experimental": {
|
|
866
|
+
"aggressive_truncation": true,
|
|
867
|
+
"empty_message_recovery": true,
|
|
868
|
+
"auto_resume": true
|
|
869
|
+
}
|
|
870
|
+
}
|
|
871
|
+
```
|
|
872
|
+
|
|
873
|
+
| Option | Default | Description |
|
|
874
|
+
| ------------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
875
|
+
| `aggressive_truncation` | `false` | When token limit is exceeded, aggressively truncates tool outputs to fit within limits. More aggressive than the default truncation behavior. Falls back to summarize/revert if insufficient. |
|
|
876
|
+
| `empty_message_recovery` | `false` | Automatically recovers from "non-empty content" API errors by fixing empty messages in the session. Up to 3 recovery attempts before giving up. |
|
|
877
|
+
| `auto_resume` | `false` | Automatically resumes session after successful recovery from thinking block errors or thinking disabled violations. Extracts the last user message and continues. |
|
|
878
|
+
|
|
879
|
+
**Warning**: These features are experimental and may cause unexpected behavior. Enable only if you understand the implications.
|
|
880
|
+
|
|
848
881
|
|
|
849
882
|
## Author's Note
|
|
850
883
|
|