oh-my-opencode 2.13.2 → 3.0.0-beta.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 +71 -14
- package/README.md +169 -37
- package/README.zh-cn.md +68 -14
- package/dist/agents/metis.d.ts +18 -0
- package/dist/agents/momus.d.ts +6 -0
- package/dist/agents/orchestrator-sisyphus.d.ts +19 -0
- package/dist/agents/plan-prompt.d.ts +8 -5
- package/dist/agents/prometheus-prompt.d.ts +27 -0
- package/dist/agents/sisyphus-junior.d.ts +3 -0
- package/dist/agents/types.d.ts +1 -1
- package/dist/agents/utils.d.ts +4 -1
- package/dist/auth/antigravity/accounts.d.ts +40 -0
- package/dist/auth/antigravity/accounts.test.d.ts +1 -0
- package/dist/auth/antigravity/browser.d.ts +27 -0
- package/dist/auth/antigravity/browser.test.d.ts +1 -0
- package/dist/auth/antigravity/cli.d.ts +2 -0
- package/dist/auth/antigravity/cli.test.d.ts +1 -0
- package/dist/auth/antigravity/constants.d.ts +63 -1
- package/dist/auth/antigravity/constants.test.d.ts +1 -0
- package/dist/auth/antigravity/fetch.d.ts +2 -1
- package/dist/auth/antigravity/integration.test.d.ts +10 -0
- package/dist/auth/antigravity/oauth.d.ts +6 -40
- package/dist/auth/antigravity/oauth.test.d.ts +1 -0
- package/dist/auth/antigravity/request.d.ts +12 -0
- package/dist/auth/antigravity/request.test.d.ts +1 -0
- package/dist/auth/antigravity/storage.d.ts +5 -0
- package/dist/auth/antigravity/storage.test.d.ts +1 -0
- package/dist/auth/antigravity/thinking.d.ts +45 -1
- package/dist/auth/antigravity/thinking.test.d.ts +10 -0
- package/dist/auth/antigravity/token.test.d.ts +1 -0
- package/dist/auth/antigravity/types.d.ts +29 -5
- package/dist/cli/commands/auth.d.ts +2 -0
- package/dist/cli/index.js +341 -116
- package/dist/config/schema.d.ts +281 -7
- package/dist/features/background-agent/concurrency.d.ts +10 -0
- package/dist/features/background-agent/concurrency.test.d.ts +1 -0
- package/dist/features/background-agent/index.d.ts +1 -0
- package/dist/features/background-agent/manager.d.ts +16 -2
- package/dist/features/background-agent/types.d.ts +26 -0
- package/dist/features/boulder-state/constants.d.ts +10 -0
- package/dist/features/boulder-state/index.d.ts +3 -0
- package/dist/features/boulder-state/storage.d.ts +28 -0
- package/dist/features/boulder-state/storage.test.d.ts +1 -0
- package/dist/features/boulder-state/types.d.ts +24 -0
- package/dist/features/builtin-commands/templates/init-deep.d.ts +1 -1
- package/dist/features/builtin-commands/templates/refactor.d.ts +1 -1
- package/dist/features/builtin-commands/templates/start-work.d.ts +1 -0
- package/dist/features/builtin-commands/types.d.ts +1 -1
- package/dist/features/hook-message-injector/injector.d.ts +2 -2
- package/dist/features/hook-message-injector/types.d.ts +3 -2
- package/dist/features/opencode-skill-loader/index.d.ts +1 -0
- package/dist/features/opencode-skill-loader/skill-content.d.ts +5 -0
- package/dist/features/opencode-skill-loader/skill-content.test.d.ts +1 -0
- package/dist/features/task-toast-manager/index.d.ts +2 -0
- package/dist/features/task-toast-manager/manager.d.ts +56 -0
- package/dist/features/task-toast-manager/manager.test.d.ts +1 -0
- package/dist/features/task-toast-manager/types.d.ts +16 -0
- package/dist/google-auth.js +2167 -161
- package/dist/hooks/agent-usage-reminder/constants.d.ts +1 -1
- package/dist/hooks/auto-slash-command/executor.d.ts +5 -1
- package/dist/hooks/auto-slash-command/index.d.ts +5 -1
- package/dist/hooks/claude-code-hooks/index.d.ts +2 -1
- package/dist/hooks/claude-code-hooks/types.d.ts +1 -0
- package/dist/hooks/index.d.ts +4 -0
- package/dist/hooks/keyword-detector/index.test.d.ts +1 -0
- package/dist/hooks/prometheus-md-only/constants.d.ts +6 -0
- package/dist/hooks/prometheus-md-only/index.d.ts +12 -0
- package/dist/hooks/prometheus-md-only/index.test.d.ts +1 -0
- package/dist/hooks/sisyphus-orchestrator/index.d.ts +35 -0
- package/dist/hooks/sisyphus-orchestrator/index.test.d.ts +1 -0
- package/dist/hooks/start-work/index.d.ts +16 -0
- package/dist/hooks/start-work/index.test.d.ts +1 -0
- package/dist/hooks/task-resume-info/index.d.ts +11 -0
- package/dist/hooks/todo-continuation-enforcer.d.ts +1 -0
- package/dist/index.js +23047 -14427
- package/dist/mcp/index.d.ts +4 -2
- package/dist/mcp/types.d.ts +1 -0
- package/dist/mcp/websearch.d.ts +8 -0
- package/dist/shared/external-plugin-detector.d.ts +18 -0
- package/dist/shared/external-plugin-detector.test.d.ts +1 -0
- package/dist/shared/index.d.ts +1 -0
- package/dist/shared/migration.d.ts +6 -0
- package/dist/tools/background-task/index.d.ts +1 -1
- package/dist/tools/call-omo-agent/constants.d.ts +1 -1
- package/dist/tools/index.d.ts +1 -0
- package/dist/tools/sisyphus-task/constants.d.ts +12 -0
- package/dist/tools/sisyphus-task/index.d.ts +3 -0
- package/dist/tools/sisyphus-task/tools.d.ts +16 -0
- package/dist/tools/sisyphus-task/tools.test.d.ts +1 -0
- package/dist/tools/sisyphus-task/types.d.ts +9 -0
- package/dist/tools/slashcommand/types.d.ts +2 -1
- package/package.json +3 -2
- package/README.ko.md +0 -1040
package/README.ja.md
CHANGED
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
> | [<img alt="Discord link" src="https://img.shields.io/discord/1452487457085063218?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=flat-square" width="156px" />](https://discord.gg/PUwSMR9XNk) | [Discordコミュニティ](https://discord.gg/PUwSMR9XNk)に参加して、コントリビューターや`oh-my-opencode`仲間とつながりましょう。 |
|
|
11
11
|
> | :-----| :----- |
|
|
12
12
|
> | [<img alt="X link" src="https://img.shields.io/badge/Follow-%40justsisyphus-00CED1?style=flat-square&logo=x&labelColor=black" width="156px" />](https://x.com/justsisyphus) | `oh-my-opencode`に関するニュースは私のXアカウントで投稿していましたが、無実の罪で凍結されたため、<br />[@justsisyphus](https://x.com/justsisyphus)が代わりに更新を投稿しています。 |
|
|
13
|
+
> | [<img alt="GitHub Follow" src="https://img.shields.io/github/followers/code-yeongyu?style=flat-square&logo=github&labelColor=black&color=24292f" width="156px" />](https://github.com/code-yeongyu) | GitHubで[@code-yeongyu](https://github.com/code-yeongyu)をフォローして、他のプロジェクトもチェックしてください。 |
|
|
13
14
|
|
|
14
15
|
<!-- <CENTERED SECTION FOR GITHUB DISPLAY> -->
|
|
15
16
|
|
|
@@ -44,12 +45,18 @@
|
|
|
44
45
|
|
|
45
46
|
## ユーザーレビュー
|
|
46
47
|
|
|
48
|
+
> "Cursorのサブスクリプションを解約しました。オープンソースコミュニティで信じられないことが起きています。" - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
|
|
49
|
+
|
|
47
50
|
> "人間が3ヶ月かかる仕事をClaude Codeが7日でやるなら、Sisyphusは1時間でやります。タスクが完了するまでただ動き続ける。It is a discipline agent." — B, Quant Researcher
|
|
48
51
|
|
|
49
52
|
> "Oh My Opencodeを使って、たった1日で8000個のeslint警告を解消しました" — [Jacob Ferrari](https://x.com/jacobferrari_/status/2003258761952289061)
|
|
50
53
|
|
|
51
54
|
> "Ohmyopencodeとralph loopを使って、一晩で45,000行のtauriアプリをSaaSウェブアプリに変換しました。インタビュープロンプトから始めて、質問に対する評価と推奨を求めました。作業する様子を見ているのは驚きでしたし、朝起きたらほぼ完成したウェブサイトがありました!" - [James Hargis](https://x.com/hargabyte/status/2007299688261882202)
|
|
52
55
|
|
|
56
|
+
> "oh-my-opencodeを使ってください、もう戻れませんよ" — [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
|
|
57
|
+
|
|
58
|
+
> "何どうすごいのかあまり言語化できてないけど、開発体験が異次元に上がった。" - [苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
|
|
59
|
+
|
|
53
60
|
> "今週末はopen code、oh my opencode、supermemoryでマインクラフト/ソウルライクな何かを作る実験をしています。"
|
|
54
61
|
> "昼食後の散歩に行く間に、しゃがみアニメーションを追加するよう頼みました。[動画]" - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
|
|
55
62
|
|
|
@@ -57,16 +64,8 @@
|
|
|
57
64
|
|
|
58
65
|
> "@yeon_gyu_kimを説得できるなら雇うべきです。彼はopencodeに革命を起こしました" — [mysticaltech](https://x.com/mysticaltech/status/2001858758608376079)
|
|
59
66
|
|
|
60
|
-
> "やばい、これマジで本物だ @androolloyd oh my opencode 最高すぎる" — [z80.eth](https://x.com/0xz80/status/2001815226505924791)
|
|
61
|
-
|
|
62
|
-
> "oh-my-opencodeを使ってください、もう戻れませんよ" — [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
|
|
63
|
-
|
|
64
|
-
> "Oh My Opencodeは頂点に立っています、敵はいません" — [RyanOnThePath](https://x.com/RyanOnThePath/status/2001438321252118548)
|
|
65
|
-
|
|
66
67
|
> "Oh My OpenCode Is Actually Insane" - [YouTube - Darren Builds AI](https://www.youtube.com/watch?v=G_Snfh2M41M)
|
|
67
68
|
|
|
68
|
-
> "シジフォスという名前自体が美しいじゃないですか?" — Sigrid ([@sigridjin_eth](https://x.com/sigridjin_eth))
|
|
69
|
-
|
|
70
69
|
---
|
|
71
70
|
|
|
72
71
|
## 目次
|
|
@@ -207,6 +206,9 @@ Windows から Linux に初めて乗り換えた時のこと、自分の思い
|
|
|
207
206
|
### 人間の方へ
|
|
208
207
|
|
|
209
208
|
面倒な作業は LLM エージェントに任せましょう。このリンクをコピーして貼り付け、インストールと設定をお願いしてください。
|
|
209
|
+
```
|
|
210
|
+
Install and configure by following the instructions here https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/README.md
|
|
211
|
+
```
|
|
210
212
|
|
|
211
213
|
### LLM エージェントの方へ
|
|
212
214
|
|
|
@@ -299,7 +301,7 @@ opencode auth login
|
|
|
299
301
|
{
|
|
300
302
|
"plugin": [
|
|
301
303
|
"oh-my-opencode",
|
|
302
|
-
"opencode-antigravity-auth@1.2.
|
|
304
|
+
"opencode-antigravity-auth@1.2.8"
|
|
303
305
|
]
|
|
304
306
|
}
|
|
305
307
|
```
|
|
@@ -642,7 +644,8 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
|
|
|
642
644
|
"commands": false,
|
|
643
645
|
"skills": false,
|
|
644
646
|
"agents": false,
|
|
645
|
-
"hooks": false
|
|
647
|
+
"hooks": false,
|
|
648
|
+
"plugins": false
|
|
646
649
|
}
|
|
647
650
|
}
|
|
648
651
|
```
|
|
@@ -654,9 +657,25 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
|
|
|
654
657
|
| `skills` | `~/.claude/skills/*/SKILL.md`, `./.claude/skills/*/SKILL.md` | - |
|
|
655
658
|
| `agents` | `~/.claude/agents/*.md`, `./.claude/agents/*.md` | 内蔵エージェント (oracle, librarian 等) |
|
|
656
659
|
| `hooks` | `~/.claude/settings.json`, `./.claude/settings.json`, `./.claude/settings.local.json` | - |
|
|
660
|
+
| `plugins` | `~/.claude/plugins/` (Claude Code マーケットプレイスプラグイン) | - |
|
|
657
661
|
|
|
658
662
|
すべてのトグルはデフォルトで `true` (有効) です。完全な Claude Code 互換性を望む場合は `claude_code` オブジェクトを省略してください。
|
|
659
663
|
|
|
664
|
+
**特定のプラグインだけを無効化** するには `plugins_override` を使用します:
|
|
665
|
+
|
|
666
|
+
```json
|
|
667
|
+
{
|
|
668
|
+
"claude_code": {
|
|
669
|
+
"plugins_override": {
|
|
670
|
+
"claude-mem@thedotmack": false,
|
|
671
|
+
"some-other-plugin@marketplace": false
|
|
672
|
+
}
|
|
673
|
+
}
|
|
674
|
+
}
|
|
675
|
+
```
|
|
676
|
+
|
|
677
|
+
プラグインシステム自体は有効にしたまま、特定のプラグインだけをその完全な識別子 (`plugin-name@marketplace-name`) で無効化できます。
|
|
678
|
+
|
|
660
679
|
### エージェントのためだけでなく、あなたのために
|
|
661
680
|
|
|
662
681
|
エージェントが活躍すれば、あなたも幸せになります。ですが、私はあなた自身も助けたいのです。
|
|
@@ -843,7 +862,8 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
|
|
|
843
862
|
|
|
844
863
|
- **Sisyphus**: プライマリオーケストレーターエージェント (Claude Opus 4.5)
|
|
845
864
|
- **OpenCode-Builder**: OpenCode のデフォルトビルドエージェント(SDK 制限により名前変更、デフォルトで無効)
|
|
846
|
-
- **Planner
|
|
865
|
+
- **Prometheus (Planner)**: OpenCode のデフォルトプランエージェント + work-planner 方法論(デフォルトで有効)
|
|
866
|
+
- **Metis (Plan Consultant)**: 隠された要件と AI 失敗ポイントを特定する事前計画分析エージェント
|
|
847
867
|
|
|
848
868
|
**設定オプション:**
|
|
849
869
|
|
|
@@ -892,8 +912,11 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
|
|
|
892
912
|
"OpenCode-Builder": {
|
|
893
913
|
"model": "anthropic/claude-opus-4"
|
|
894
914
|
},
|
|
895
|
-
"Planner
|
|
915
|
+
"Prometheus (Planner)": {
|
|
896
916
|
"model": "openai/gpt-5.2"
|
|
917
|
+
},
|
|
918
|
+
"Metis (Plan Consultant)": {
|
|
919
|
+
"model": "anthropic/claude-sonnet-4-5"
|
|
897
920
|
}
|
|
898
921
|
}
|
|
899
922
|
}
|
|
@@ -903,8 +926,42 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
|
|
|
903
926
|
| --------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
904
927
|
| `disabled` | `false` | `true` の場合、すべての Sisyphus オーケストレーションを無効化し、元の build/plan をプライマリとして復元します。 |
|
|
905
928
|
| `default_builder_enabled` | `false` | `true` の場合、OpenCode-Builder エージェントを有効化します(OpenCode build と同じ、SDK 制限により名前変更)。デフォルトでは無効です。 |
|
|
906
|
-
| `planner_enabled` | `true` | `true` の場合、Planner
|
|
907
|
-
| `replace_plan` | `true` | `true` の場合、デフォルトのプランエージェントをサブエージェントモードに降格させます。`false` に設定すると、Planner
|
|
929
|
+
| `planner_enabled` | `true` | `true` の場合、Prometheus (Planner) エージェントを有効化します(work-planner 方法論を含む)。デフォルトで有効です。 |
|
|
930
|
+
| `replace_plan` | `true` | `true` の場合、デフォルトのプランエージェントをサブエージェントモードに降格させます。`false` に設定すると、Prometheus (Planner) とデフォルトのプランの両方を利用できます。 |
|
|
931
|
+
|
|
932
|
+
### Background Tasks
|
|
933
|
+
|
|
934
|
+
バックグラウンドエージェントタスクの同時実行数を設定します。並列で実行できるバックグラウンドエージェントの数を制御します。
|
|
935
|
+
|
|
936
|
+
```json
|
|
937
|
+
{
|
|
938
|
+
"background_task": {
|
|
939
|
+
"defaultConcurrency": 5,
|
|
940
|
+
"providerConcurrency": {
|
|
941
|
+
"anthropic": 3,
|
|
942
|
+
"openai": 5,
|
|
943
|
+
"google": 10
|
|
944
|
+
},
|
|
945
|
+
"modelConcurrency": {
|
|
946
|
+
"anthropic/claude-opus-4-5": 2,
|
|
947
|
+
"google/gemini-3-flash": 10
|
|
948
|
+
}
|
|
949
|
+
}
|
|
950
|
+
}
|
|
951
|
+
```
|
|
952
|
+
|
|
953
|
+
| オプション | デフォルト | 説明 |
|
|
954
|
+
| --------------------- | ---------- | -------------------------------------------------------------------------------------------------------------- |
|
|
955
|
+
| `defaultConcurrency` | - | すべてのプロバイダー/モデルに対するデフォルトの最大同時バックグラウンドタスク数 |
|
|
956
|
+
| `providerConcurrency` | - | プロバイダーごとの同時実行制限。キーはプロバイダー名(例:`anthropic`、`openai`、`google`) |
|
|
957
|
+
| `modelConcurrency` | - | モデルごとの同時実行制限。キーは完全なモデル名(例:`anthropic/claude-opus-4-5`)。プロバイダー制限より優先されます。 |
|
|
958
|
+
|
|
959
|
+
**優先順位**: `modelConcurrency` > `providerConcurrency` > `defaultConcurrency`
|
|
960
|
+
|
|
961
|
+
**ユースケース**:
|
|
962
|
+
- 高価なモデル(例:Opus)を制限してコストの急増を防ぐ
|
|
963
|
+
- 高速で安価なモデル(例:Gemini Flash)により多くの同時タスクを許可する
|
|
964
|
+
- プロバイダーレベルの上限を設定してプロバイダーのレートリミットを遵守する
|
|
908
965
|
|
|
909
966
|
### Hooks
|
|
910
967
|
|
package/README.md
CHANGED
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
> | [<img alt="Discord link" src="https://img.shields.io/discord/1452487457085063218?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=flat-square" width="156px" />](https://discord.gg/PUwSMR9XNk) | Join our [Discord community](https://discord.gg/PUwSMR9XNk) to connect with contributors and fellow `oh-my-opencode` users. |
|
|
11
11
|
> | :-----| :----- |
|
|
12
12
|
> | [<img alt="X link" src="https://img.shields.io/badge/Follow-%40justsisyphus-00CED1?style=flat-square&logo=x&labelColor=black" width="156px" />](https://x.com/justsisyphus) | News and updates for `oh-my-opencode` used to be posted on my X account. <br /> Since it was suspended mistakenly, [@justsisyphus](https://x.com/justsisyphus) now posts updates on my behalf. |
|
|
13
|
+
> | [<img alt="GitHub Follow" src="https://img.shields.io/github/followers/code-yeongyu?style=flat-square&logo=github&labelColor=black&color=24292f" width="156px" />](https://github.com/code-yeongyu) | Follow [@code-yeongyu](https://github.com/code-yeongyu) on GitHub for more projects. |
|
|
13
14
|
|
|
14
15
|
<!-- <CENTERED SECTION FOR GITHUB DISPLAY> -->
|
|
15
16
|
|
|
@@ -41,7 +42,7 @@ No stupid token consumption massive subagents here. No bloat tools here.
|
|
|
41
42
|
[](https://github.com/code-yeongyu/oh-my-opencode/issues)
|
|
42
43
|
[](https://github.com/code-yeongyu/oh-my-opencode/blob/master/LICENSE.md)
|
|
43
44
|
|
|
44
|
-
[English](README.md) | [
|
|
45
|
+
[English](README.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md)
|
|
45
46
|
|
|
46
47
|
</div>
|
|
47
48
|
|
|
@@ -49,12 +50,19 @@ No stupid token consumption massive subagents here. No bloat tools here.
|
|
|
49
50
|
|
|
50
51
|
## Reviews
|
|
51
52
|
|
|
53
|
+
> "It made me cancel my Cursor subscription. Unbelievable things are happening in the open source community." - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
|
|
54
|
+
|
|
52
55
|
> "If Claude Code does in 7 days what a human does in 3 months, Sisyphus does it in 1 hour. It just works until the task is done. It is a discipline agent." — B, Quant Researcher
|
|
53
56
|
|
|
54
57
|
> "Knocked out 8000 eslint warnings with Oh My Opencode, just in a day" — [Jacob Ferrari](https://x.com/jacobferrari_/status/2003258761952289061)
|
|
55
58
|
|
|
56
59
|
> "I converted a 45k line tauri app into a SaaS web app overnight using Ohmyopencode and ralph loop. Started with interview me prompt, asked it for ratings and recommendations on the questions. It was amazing to watch it work and to wake up this morning to a mostly working website!" - [James Hargis](https://x.com/hargabyte/status/2007299688261882202)
|
|
57
60
|
|
|
61
|
+
> "use oh-my-opencode, you will never go back" — [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
|
|
62
|
+
|
|
63
|
+
> "I haven't really been able to articulate exactly what makes it so great yet, but the development experience has reached a completely different dimension." - [
|
|
64
|
+
苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
|
|
65
|
+
|
|
58
66
|
> "Experimenting with open code, oh my opencode and supermemory this weekend to build some minecraft/souls-like abomination."
|
|
59
67
|
> "Asking it to add crouch animations while I go take my post-lunch walk. [Video]" - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
|
|
60
68
|
|
|
@@ -62,15 +70,7 @@ No stupid token consumption massive subagents here. No bloat tools here.
|
|
|
62
70
|
|
|
63
71
|
> "Hire @yeon_gyu_kim if you can convince him, this dude has revolutionized opencode." — [mysticaltech](https://x.com/mysticaltech/status/2001858758608376079)
|
|
64
72
|
|
|
65
|
-
> "ok yeah holy shit @androolloyd this thing is legit oh my opencode is sick" — [z80.eth](https://x.com/0xz80/status/2001815226505924791)
|
|
66
|
-
|
|
67
|
-
> "use oh-my-opencode, you will never go back" — [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
|
|
68
|
-
|
|
69
|
-
> "Oh My Opencode is king of the hill and has no contenders" — [RyanOnThePath](https://x.com/RyanOnThePath/status/2001438321252118548)
|
|
70
|
-
|
|
71
73
|
> "Oh My OpenCode Is Actually Insane" - [YouTube - Darren Builds AI](https://www.youtube.com/watch?v=G_Snfh2M41M)
|
|
72
|
-
>
|
|
73
|
-
> "Isn't the name Sisyphus beautiful by itself?" — Sigrid ([@sigridjin_eth](https://x.com/sigridjin_eth))
|
|
74
74
|
|
|
75
75
|
---
|
|
76
76
|
|
|
@@ -79,25 +79,28 @@ No stupid token consumption massive subagents here. No bloat tools here.
|
|
|
79
79
|
- [Oh My OpenCode](#oh-my-opencode)
|
|
80
80
|
- [Just Skip Reading This Readme](#just-skip-reading-this-readme)
|
|
81
81
|
- [It's the Age of Agents](#its-the-age-of-agents)
|
|
82
|
+
- [🪄 The Magic Word: `ultrawork`](#-the-magic-word-ultrawork)
|
|
82
83
|
- [For Those Who Want to Read: Meet Sisyphus](#for-those-who-want-to-read-meet-sisyphus)
|
|
83
84
|
- [Just Install It.](#just-install-it)
|
|
84
85
|
- [Installation](#installation)
|
|
85
86
|
- [For Humans](#for-humans)
|
|
86
87
|
- [For LLM Agents](#for-llm-agents)
|
|
87
|
-
- [Step 0: Ask user about
|
|
88
|
-
- [Step 1: Install OpenCode
|
|
89
|
-
- [Step 2:
|
|
90
|
-
- [JSONC](#jsonc)
|
|
91
|
-
- [JSON](#json)
|
|
88
|
+
- [Step 0: Ask user about subscriptions](#step-0-ask-user-about-subscriptions)
|
|
89
|
+
- [Step 1: Install OpenCode (if not installed)](#step-1-install-opencode-if-not-installed)
|
|
90
|
+
- [Step 2: Run the installer](#step-2-run-the-installer)
|
|
92
91
|
- [Step 3: Verify Setup](#step-3-verify-setup)
|
|
93
92
|
- [Step 4: Configure Authentication](#step-4-configure-authentication)
|
|
94
93
|
- [Anthropic (Claude)](#anthropic-claude)
|
|
95
94
|
- [Google Gemini (Antigravity OAuth)](#google-gemini-antigravity-oauth)
|
|
96
|
-
- [OpenAI (ChatGPT Plus/Pro)](#openai-chatgpt-pluspro)
|
|
97
95
|
- [Model Configuration](#model-configuration)
|
|
96
|
+
- [oh-my-opencode Agent Model Override](#oh-my-opencode-agent-model-override)
|
|
97
|
+
- [OpenAI (ChatGPT Plus/Pro)](#openai-chatgpt-pluspro)
|
|
98
|
+
- [Model Configuration](#model-configuration-1)
|
|
98
99
|
- [⚠️ Warning](#️-warning)
|
|
99
100
|
- [Verify the setup](#verify-the-setup)
|
|
100
101
|
- [Say 'Congratulations! 🎉' to the user](#say-congratulations--to-the-user)
|
|
102
|
+
- [Free advertising](#free-advertising)
|
|
103
|
+
- [Ask for a Star ⭐](#ask-for-a-star-)
|
|
101
104
|
- [Too Complicated?](#too-complicated)
|
|
102
105
|
- [Uninstallation](#uninstallation)
|
|
103
106
|
- [Features](#features)
|
|
@@ -105,9 +108,11 @@ No stupid token consumption massive subagents here. No bloat tools here.
|
|
|
105
108
|
- [Background Agents: Work Like a Team](#background-agents-work-like-a-team)
|
|
106
109
|
- [The Tools: Your Teammates Deserve Better](#the-tools-your-teammates-deserve-better)
|
|
107
110
|
- [Why Are You the Only One Using an IDE?](#why-are-you-the-only-one-using-an-ide)
|
|
111
|
+
- [Session Management](#session-management)
|
|
108
112
|
- [Context Is All You Need](#context-is-all-you-need)
|
|
109
113
|
- [Be Multimodal. Save Tokens.](#be-multimodal-save-tokens)
|
|
110
114
|
- [I Removed Their Blockers](#i-removed-their-blockers)
|
|
115
|
+
- [Skill-Embedded MCP Support](#skill-embedded-mcp-support)
|
|
111
116
|
- [Goodbye Claude Code. Hello Oh My OpenCode.](#goodbye-claude-code-hello-oh-my-opencode)
|
|
112
117
|
- [Hooks Integration](#hooks-integration)
|
|
113
118
|
- [Config Loaders](#config-loaders)
|
|
@@ -115,16 +120,22 @@ No stupid token consumption massive subagents here. No bloat tools here.
|
|
|
115
120
|
- [Compatibility Toggles](#compatibility-toggles)
|
|
116
121
|
- [Not Just for the Agents](#not-just-for-the-agents)
|
|
117
122
|
- [Configuration](#configuration)
|
|
123
|
+
- [JSONC Support](#jsonc-support)
|
|
118
124
|
- [Google Auth](#google-auth)
|
|
119
125
|
- [Agents](#agents)
|
|
120
126
|
- [Permission Options](#permission-options)
|
|
127
|
+
- [Built-in Skills](#built-in-skills)
|
|
121
128
|
- [Sisyphus Agent](#sisyphus-agent)
|
|
129
|
+
- [Background Tasks](#background-tasks)
|
|
130
|
+
- [Categories](#categories)
|
|
122
131
|
- [Hooks](#hooks)
|
|
123
132
|
- [MCPs](#mcps)
|
|
124
133
|
- [LSP](#lsp)
|
|
125
134
|
- [Experimental](#experimental)
|
|
126
135
|
- [Author's Note](#authors-note)
|
|
127
136
|
- [Warnings](#warnings)
|
|
137
|
+
- [Loved by professionals at](#loved-by-professionals-at)
|
|
138
|
+
- [Sponsors](#sponsors)
|
|
128
139
|
|
|
129
140
|
# Oh My OpenCode
|
|
130
141
|
|
|
@@ -329,7 +340,7 @@ First, add the opencode-antigravity-auth plugin:
|
|
|
329
340
|
{
|
|
330
341
|
"plugin": [
|
|
331
342
|
"oh-my-opencode",
|
|
332
|
-
"opencode-antigravity-auth@1.2.
|
|
343
|
+
"opencode-antigravity-auth@1.2.8"
|
|
333
344
|
]
|
|
334
345
|
}
|
|
335
346
|
```
|
|
@@ -543,6 +554,7 @@ Hand your best tools to your best colleagues. Now they can properly refactor, na
|
|
|
543
554
|
- **ast_grep_search**: AST-aware code pattern search (25 languages)
|
|
544
555
|
- **ast_grep_replace**: AST-aware code replacement
|
|
545
556
|
- **call_omo_agent**: Spawn specialized explore/librarian agents. Supports `run_in_background` parameter for async execution.
|
|
557
|
+
- **sisyphus_task**: Category-based task delegation with specialized agents. Supports pre-configured categories (visual, business-logic) or direct agent targeting. Use `background_output` to retrieve results and `background_cancel` to cancel tasks. See [Categories](#categories).
|
|
546
558
|
|
|
547
559
|
#### Session Management
|
|
548
560
|
|
|
@@ -582,6 +594,7 @@ These tools enable agents to reference previous conversations and maintain conti
|
|
|
582
594
|
- Use camelCase for function names
|
|
583
595
|
```
|
|
584
596
|
- **Online**: Project rules aren't everything. Built-in MCPs for extended capabilities:
|
|
597
|
+
- **websearch**: Real-time web search powered by [Exa AI](https://exa.ai)
|
|
585
598
|
- **context7**: Official documentation lookup
|
|
586
599
|
- **grep_app**: Ultra-fast code search across public GitHub repos (great for finding implementation examples)
|
|
587
600
|
|
|
@@ -687,7 +700,8 @@ Disable specific Claude Code compatibility features with the `claude_code` confi
|
|
|
687
700
|
"commands": false,
|
|
688
701
|
"skills": false,
|
|
689
702
|
"agents": false,
|
|
690
|
-
"hooks": false
|
|
703
|
+
"hooks": false,
|
|
704
|
+
"plugins": false
|
|
691
705
|
}
|
|
692
706
|
}
|
|
693
707
|
```
|
|
@@ -699,9 +713,25 @@ Disable specific Claude Code compatibility features with the `claude_code` confi
|
|
|
699
713
|
| `skills` | `~/.claude/skills/*/SKILL.md`, `./.claude/skills/*/SKILL.md` | - |
|
|
700
714
|
| `agents` | `~/.claude/agents/*.md`, `./.claude/agents/*.md` | Built-in agents (oracle, librarian, etc.) |
|
|
701
715
|
| `hooks` | `~/.claude/settings.json`, `./.claude/settings.json`, `./.claude/settings.local.json` | - |
|
|
716
|
+
| `plugins` | `~/.claude/plugins/` (Claude Code marketplace plugins) | - |
|
|
702
717
|
|
|
703
718
|
All toggles default to `true` (enabled). Omit the `claude_code` object for full Claude Code compatibility.
|
|
704
719
|
|
|
720
|
+
**Selectively disable specific plugins** using `plugins_override`:
|
|
721
|
+
|
|
722
|
+
```json
|
|
723
|
+
{
|
|
724
|
+
"claude_code": {
|
|
725
|
+
"plugins_override": {
|
|
726
|
+
"claude-mem@thedotmack": false,
|
|
727
|
+
"some-other-plugin@marketplace": false
|
|
728
|
+
}
|
|
729
|
+
}
|
|
730
|
+
}
|
|
731
|
+
```
|
|
732
|
+
|
|
733
|
+
This allows you to keep the plugin system enabled while disabling specific plugins by their full identifier (`plugin-name@marketplace-name`).
|
|
734
|
+
|
|
705
735
|
### Not Just for the Agents
|
|
706
736
|
|
|
707
737
|
When agents thrive, you thrive. But I want to help you directly too.
|
|
@@ -744,10 +774,10 @@ Config file locations (priority order):
|
|
|
744
774
|
1. `.opencode/oh-my-opencode.json` (project)
|
|
745
775
|
2. User config (platform-specific):
|
|
746
776
|
|
|
747
|
-
| Platform
|
|
748
|
-
|
|
749
|
-
| **Windows**
|
|
750
|
-
| **macOS/Linux** | `~/.config/opencode/oh-my-opencode.json`
|
|
777
|
+
| Platform | User Config Path |
|
|
778
|
+
| --------------- | ----------------------------------------------------------------------------------------------------------- |
|
|
779
|
+
| **Windows** | `~/.config/opencode/oh-my-opencode.json` (preferred) or `%APPDATA%\opencode\oh-my-opencode.json` (fallback) |
|
|
780
|
+
| **macOS/Linux** | `~/.config/opencode/oh-my-opencode.json` |
|
|
751
781
|
|
|
752
782
|
Schema autocomplete supported:
|
|
753
783
|
|
|
@@ -771,10 +801,10 @@ When both `oh-my-opencode.jsonc` and `oh-my-opencode.json` files exist, `.jsonc`
|
|
|
771
801
|
```jsonc
|
|
772
802
|
{
|
|
773
803
|
"$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
|
|
774
|
-
|
|
804
|
+
|
|
775
805
|
// Enable Google Gemini via Antigravity OAuth
|
|
776
806
|
"google_auth": false,
|
|
777
|
-
|
|
807
|
+
|
|
778
808
|
/* Agent overrides - customize models for specific tasks */
|
|
779
809
|
"agents": {
|
|
780
810
|
"oracle": {
|
|
@@ -887,6 +917,7 @@ Available agents: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `
|
|
|
887
917
|
Oh My OpenCode includes built-in skills that provide additional capabilities:
|
|
888
918
|
|
|
889
919
|
- **playwright**: Browser automation with Playwright MCP. Use for web scraping, testing, screenshots, and browser interactions.
|
|
920
|
+
- **git-master**: Git expert for atomic commits, rebase/squash, and history search (blame, bisect, log -S). STRONGLY RECOMMENDED: Use with `sisyphus_task(category='quick', skills=['git-master'], ...)` to save context.
|
|
890
921
|
|
|
891
922
|
Disable built-in skills via `disabled_skills` in `~/.config/opencode/oh-my-opencode.json` or `.opencode/oh-my-opencode.json`:
|
|
892
923
|
|
|
@@ -896,7 +927,25 @@ Disable built-in skills via `disabled_skills` in `~/.config/opencode/oh-my-openc
|
|
|
896
927
|
}
|
|
897
928
|
```
|
|
898
929
|
|
|
899
|
-
Available built-in skills: `playwright`
|
|
930
|
+
Available built-in skills: `playwright`, `git-master`
|
|
931
|
+
|
|
932
|
+
### Git Master
|
|
933
|
+
|
|
934
|
+
Configure git-master skill behavior:
|
|
935
|
+
|
|
936
|
+
```json
|
|
937
|
+
{
|
|
938
|
+
"git_master": {
|
|
939
|
+
"commit_footer": true,
|
|
940
|
+
"include_co_authored_by": true
|
|
941
|
+
}
|
|
942
|
+
}
|
|
943
|
+
```
|
|
944
|
+
|
|
945
|
+
| Option | Default | Description |
|
|
946
|
+
| ------ | ------- | ----------- |
|
|
947
|
+
| `commit_footer` | `true` | Adds "Ultraworked with Sisyphus" footer to commit messages. |
|
|
948
|
+
| `include_co_authored_by` | `true` | Adds `Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>` trailer to commits. |
|
|
900
949
|
|
|
901
950
|
### Sisyphus Agent
|
|
902
951
|
|
|
@@ -904,7 +953,8 @@ When enabled (default), Sisyphus provides a powerful orchestrator with optional
|
|
|
904
953
|
|
|
905
954
|
- **Sisyphus**: Primary orchestrator agent (Claude Opus 4.5)
|
|
906
955
|
- **OpenCode-Builder**: OpenCode's default build agent, renamed due to SDK limitations (disabled by default)
|
|
907
|
-
- **Planner
|
|
956
|
+
- **Prometheus (Planner)**: OpenCode's default plan agent with work-planner methodology (enabled by default)
|
|
957
|
+
- **Metis (Plan Consultant)**: Pre-planning analysis agent that identifies hidden requirements and AI failure points
|
|
908
958
|
|
|
909
959
|
**Configuration Options:**
|
|
910
960
|
|
|
@@ -953,8 +1003,11 @@ You can also customize Sisyphus agents like other agents:
|
|
|
953
1003
|
"OpenCode-Builder": {
|
|
954
1004
|
"model": "anthropic/claude-opus-4"
|
|
955
1005
|
},
|
|
956
|
-
"Planner
|
|
1006
|
+
"Prometheus (Planner)": {
|
|
957
1007
|
"model": "openai/gpt-5.2"
|
|
1008
|
+
},
|
|
1009
|
+
"Metis (Plan Consultant)": {
|
|
1010
|
+
"model": "anthropic/claude-sonnet-4-5"
|
|
958
1011
|
}
|
|
959
1012
|
}
|
|
960
1013
|
}
|
|
@@ -964,8 +1017,86 @@ You can also customize Sisyphus agents like other agents:
|
|
|
964
1017
|
| --------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
965
1018
|
| `disabled` | `false` | When `true`, disables all Sisyphus orchestration and restores original build/plan as primary. |
|
|
966
1019
|
| `default_builder_enabled` | `false` | When `true`, enables OpenCode-Builder agent (same as OpenCode build, renamed due to SDK limitations). Disabled by default. |
|
|
967
|
-
| `planner_enabled` | `true` | When `true`, enables Planner
|
|
968
|
-
| `replace_plan` | `true` | When `true`, demotes default plan agent to subagent mode. Set to `false` to keep both Planner
|
|
1020
|
+
| `planner_enabled` | `true` | When `true`, enables Prometheus (Planner) agent with work-planner methodology. Enabled by default. |
|
|
1021
|
+
| `replace_plan` | `true` | When `true`, demotes default plan agent to subagent mode. Set to `false` to keep both Prometheus (Planner) and default plan available. |
|
|
1022
|
+
|
|
1023
|
+
### Background Tasks
|
|
1024
|
+
|
|
1025
|
+
Configure concurrency limits for background agent tasks. This controls how many parallel background agents can run simultaneously.
|
|
1026
|
+
|
|
1027
|
+
```json
|
|
1028
|
+
{
|
|
1029
|
+
"background_task": {
|
|
1030
|
+
"defaultConcurrency": 5,
|
|
1031
|
+
"providerConcurrency": {
|
|
1032
|
+
"anthropic": 3,
|
|
1033
|
+
"openai": 5,
|
|
1034
|
+
"google": 10
|
|
1035
|
+
},
|
|
1036
|
+
"modelConcurrency": {
|
|
1037
|
+
"anthropic/claude-opus-4-5": 2,
|
|
1038
|
+
"google/gemini-3-flash": 10
|
|
1039
|
+
}
|
|
1040
|
+
}
|
|
1041
|
+
}
|
|
1042
|
+
```
|
|
1043
|
+
|
|
1044
|
+
| Option | Default | Description |
|
|
1045
|
+
| --------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------- |
|
|
1046
|
+
| `defaultConcurrency` | - | Default maximum concurrent background tasks for all providers/models |
|
|
1047
|
+
| `providerConcurrency` | - | Per-provider concurrency limits. Keys are provider names (e.g., `anthropic`, `openai`, `google`) |
|
|
1048
|
+
| `modelConcurrency` | - | Per-model concurrency limits. Keys are full model names (e.g., `anthropic/claude-opus-4-5`). Overrides provider limits. |
|
|
1049
|
+
|
|
1050
|
+
**Priority Order**: `modelConcurrency` > `providerConcurrency` > `defaultConcurrency`
|
|
1051
|
+
|
|
1052
|
+
**Use Cases**:
|
|
1053
|
+
- Limit expensive models (e.g., Opus) to prevent cost spikes
|
|
1054
|
+
- Allow more concurrent tasks for fast/cheap models (e.g., Gemini Flash)
|
|
1055
|
+
- Respect provider rate limits by setting provider-level caps
|
|
1056
|
+
|
|
1057
|
+
### Categories
|
|
1058
|
+
|
|
1059
|
+
Categories enable domain-specific task delegation via the `sisyphus_task` tool. Each category pre-configures a specialized `Sisyphus-Junior-{category}` agent with optimized model settings and prompts.
|
|
1060
|
+
|
|
1061
|
+
**Default Categories:**
|
|
1062
|
+
|
|
1063
|
+
| Category | Model | Description |
|
|
1064
|
+
|----------|-------|-------------|
|
|
1065
|
+
| `visual` | `google/gemini-3-pro-preview` | Frontend, UI/UX, design-focused tasks. High creativity (temp 0.7). |
|
|
1066
|
+
| `business-logic` | `openai/gpt-5.2` | Backend logic, architecture, strategic reasoning. Low creativity (temp 0.1). |
|
|
1067
|
+
|
|
1068
|
+
**Usage:**
|
|
1069
|
+
|
|
1070
|
+
```
|
|
1071
|
+
// Via sisyphus_task tool
|
|
1072
|
+
sisyphus_task(category="visual", prompt="Create a responsive dashboard component")
|
|
1073
|
+
sisyphus_task(category="business-logic", prompt="Design the payment processing flow")
|
|
1074
|
+
|
|
1075
|
+
// Or target a specific agent directly
|
|
1076
|
+
sisyphus_task(agent="oracle", prompt="Review this architecture")
|
|
1077
|
+
```
|
|
1078
|
+
|
|
1079
|
+
**Custom Categories:**
|
|
1080
|
+
|
|
1081
|
+
Add custom categories in `oh-my-opencode.json`:
|
|
1082
|
+
|
|
1083
|
+
```json
|
|
1084
|
+
{
|
|
1085
|
+
"categories": {
|
|
1086
|
+
"data-science": {
|
|
1087
|
+
"model": "anthropic/claude-sonnet-4-5",
|
|
1088
|
+
"temperature": 0.2,
|
|
1089
|
+
"prompt_append": "Focus on data analysis, ML pipelines, and statistical methods."
|
|
1090
|
+
},
|
|
1091
|
+
"visual": {
|
|
1092
|
+
"model": "google/gemini-3-pro-high",
|
|
1093
|
+
"prompt_append": "Use shadcn/ui components and Tailwind CSS."
|
|
1094
|
+
}
|
|
1095
|
+
}
|
|
1096
|
+
}
|
|
1097
|
+
```
|
|
1098
|
+
|
|
1099
|
+
Each category supports: `model`, `temperature`, `top_p`, `maxTokens`, `thinking`, `reasoningEffort`, `textVerbosity`, `tools`, `prompt_append`.
|
|
969
1100
|
|
|
970
1101
|
### Hooks
|
|
971
1102
|
|
|
@@ -983,8 +1114,9 @@ Available hooks: `todo-continuation-enforcer`, `context-window-monitor`, `sessio
|
|
|
983
1114
|
|
|
984
1115
|
### MCPs
|
|
985
1116
|
|
|
986
|
-
Context7 and grep.app MCP enabled by default.
|
|
1117
|
+
Exa, Context7 and grep.app MCP enabled by default.
|
|
987
1118
|
|
|
1119
|
+
- **websearch**: Real-time web search powered by [Exa AI](https://exa.ai) - searches the web and returns relevant content
|
|
988
1120
|
- **context7**: Fetches up-to-date official documentation for libraries
|
|
989
1121
|
- **grep_app**: Ultra-fast code search across millions of public GitHub repositories via [grep.app](https://grep.app)
|
|
990
1122
|
|
|
@@ -992,7 +1124,7 @@ Don't want them? Disable via `disabled_mcps` in `~/.config/opencode/oh-my-openco
|
|
|
992
1124
|
|
|
993
1125
|
```json
|
|
994
1126
|
{
|
|
995
|
-
"disabled_mcps": ["context7", "grep_app"]
|
|
1127
|
+
"disabled_mcps": ["websearch", "context7", "grep_app"]
|
|
996
1128
|
}
|
|
997
1129
|
```
|
|
998
1130
|
|
|
@@ -1036,13 +1168,13 @@ Opt-in experimental features that may change or be removed in future versions. U
|
|
|
1036
1168
|
}
|
|
1037
1169
|
```
|
|
1038
1170
|
|
|
1039
|
-
| Option
|
|
1040
|
-
|
|
|
1041
|
-
| `preemptive_compaction_threshold` | `0.85`
|
|
1042
|
-
| `truncate_all_tool_outputs`
|
|
1043
|
-
| `aggressive_truncation`
|
|
1044
|
-
| `auto_resume`
|
|
1045
|
-
| `dcp_for_compaction`
|
|
1171
|
+
| Option | Default | Description |
|
|
1172
|
+
| --------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
1173
|
+
| `preemptive_compaction_threshold` | `0.85` | Threshold percentage (0.5-0.95) to trigger preemptive compaction. The `preemptive-compaction` hook is enabled by default; this option customizes the threshold. |
|
|
1174
|
+
| `truncate_all_tool_outputs` | `false` | Truncates ALL tool outputs instead of just whitelisted tools (Grep, Glob, LSP, AST-grep). Tool output truncator is enabled by default - disable via `disabled_hooks`. |
|
|
1175
|
+
| `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. |
|
|
1176
|
+
| `auto_resume` | `false` | Automatically resumes session after successful recovery from thinking block errors or thinking disabled violations. Extracts the last user message and continues. |
|
|
1177
|
+
| `dcp_for_compaction` | `false` | Enable DCP (Dynamic Context Pruning) for compaction - runs first when token limit exceeded. Prunes duplicate tool calls and old tool outputs before running compaction. |
|
|
1046
1178
|
|
|
1047
1179
|
**Warning**: These features are experimental and may cause unexpected behavior. Enable only if you understand the implications.
|
|
1048
1180
|
|