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.
Files changed (93) hide show
  1. package/README.ja.md +71 -14
  2. package/README.md +169 -37
  3. package/README.zh-cn.md +68 -14
  4. package/dist/agents/metis.d.ts +18 -0
  5. package/dist/agents/momus.d.ts +6 -0
  6. package/dist/agents/orchestrator-sisyphus.d.ts +19 -0
  7. package/dist/agents/plan-prompt.d.ts +8 -5
  8. package/dist/agents/prometheus-prompt.d.ts +27 -0
  9. package/dist/agents/sisyphus-junior.d.ts +3 -0
  10. package/dist/agents/types.d.ts +1 -1
  11. package/dist/agents/utils.d.ts +4 -1
  12. package/dist/auth/antigravity/accounts.d.ts +40 -0
  13. package/dist/auth/antigravity/accounts.test.d.ts +1 -0
  14. package/dist/auth/antigravity/browser.d.ts +27 -0
  15. package/dist/auth/antigravity/browser.test.d.ts +1 -0
  16. package/dist/auth/antigravity/cli.d.ts +2 -0
  17. package/dist/auth/antigravity/cli.test.d.ts +1 -0
  18. package/dist/auth/antigravity/constants.d.ts +63 -1
  19. package/dist/auth/antigravity/constants.test.d.ts +1 -0
  20. package/dist/auth/antigravity/fetch.d.ts +2 -1
  21. package/dist/auth/antigravity/integration.test.d.ts +10 -0
  22. package/dist/auth/antigravity/oauth.d.ts +6 -40
  23. package/dist/auth/antigravity/oauth.test.d.ts +1 -0
  24. package/dist/auth/antigravity/request.d.ts +12 -0
  25. package/dist/auth/antigravity/request.test.d.ts +1 -0
  26. package/dist/auth/antigravity/storage.d.ts +5 -0
  27. package/dist/auth/antigravity/storage.test.d.ts +1 -0
  28. package/dist/auth/antigravity/thinking.d.ts +45 -1
  29. package/dist/auth/antigravity/thinking.test.d.ts +10 -0
  30. package/dist/auth/antigravity/token.test.d.ts +1 -0
  31. package/dist/auth/antigravity/types.d.ts +29 -5
  32. package/dist/cli/commands/auth.d.ts +2 -0
  33. package/dist/cli/index.js +341 -116
  34. package/dist/config/schema.d.ts +281 -7
  35. package/dist/features/background-agent/concurrency.d.ts +10 -0
  36. package/dist/features/background-agent/concurrency.test.d.ts +1 -0
  37. package/dist/features/background-agent/index.d.ts +1 -0
  38. package/dist/features/background-agent/manager.d.ts +16 -2
  39. package/dist/features/background-agent/types.d.ts +26 -0
  40. package/dist/features/boulder-state/constants.d.ts +10 -0
  41. package/dist/features/boulder-state/index.d.ts +3 -0
  42. package/dist/features/boulder-state/storage.d.ts +28 -0
  43. package/dist/features/boulder-state/storage.test.d.ts +1 -0
  44. package/dist/features/boulder-state/types.d.ts +24 -0
  45. package/dist/features/builtin-commands/templates/init-deep.d.ts +1 -1
  46. package/dist/features/builtin-commands/templates/refactor.d.ts +1 -1
  47. package/dist/features/builtin-commands/templates/start-work.d.ts +1 -0
  48. package/dist/features/builtin-commands/types.d.ts +1 -1
  49. package/dist/features/hook-message-injector/injector.d.ts +2 -2
  50. package/dist/features/hook-message-injector/types.d.ts +3 -2
  51. package/dist/features/opencode-skill-loader/index.d.ts +1 -0
  52. package/dist/features/opencode-skill-loader/skill-content.d.ts +5 -0
  53. package/dist/features/opencode-skill-loader/skill-content.test.d.ts +1 -0
  54. package/dist/features/task-toast-manager/index.d.ts +2 -0
  55. package/dist/features/task-toast-manager/manager.d.ts +56 -0
  56. package/dist/features/task-toast-manager/manager.test.d.ts +1 -0
  57. package/dist/features/task-toast-manager/types.d.ts +16 -0
  58. package/dist/google-auth.js +2167 -161
  59. package/dist/hooks/agent-usage-reminder/constants.d.ts +1 -1
  60. package/dist/hooks/auto-slash-command/executor.d.ts +5 -1
  61. package/dist/hooks/auto-slash-command/index.d.ts +5 -1
  62. package/dist/hooks/claude-code-hooks/index.d.ts +2 -1
  63. package/dist/hooks/claude-code-hooks/types.d.ts +1 -0
  64. package/dist/hooks/index.d.ts +4 -0
  65. package/dist/hooks/keyword-detector/index.test.d.ts +1 -0
  66. package/dist/hooks/prometheus-md-only/constants.d.ts +6 -0
  67. package/dist/hooks/prometheus-md-only/index.d.ts +12 -0
  68. package/dist/hooks/prometheus-md-only/index.test.d.ts +1 -0
  69. package/dist/hooks/sisyphus-orchestrator/index.d.ts +35 -0
  70. package/dist/hooks/sisyphus-orchestrator/index.test.d.ts +1 -0
  71. package/dist/hooks/start-work/index.d.ts +16 -0
  72. package/dist/hooks/start-work/index.test.d.ts +1 -0
  73. package/dist/hooks/task-resume-info/index.d.ts +11 -0
  74. package/dist/hooks/todo-continuation-enforcer.d.ts +1 -0
  75. package/dist/index.js +23047 -14427
  76. package/dist/mcp/index.d.ts +4 -2
  77. package/dist/mcp/types.d.ts +1 -0
  78. package/dist/mcp/websearch.d.ts +8 -0
  79. package/dist/shared/external-plugin-detector.d.ts +18 -0
  80. package/dist/shared/external-plugin-detector.test.d.ts +1 -0
  81. package/dist/shared/index.d.ts +1 -0
  82. package/dist/shared/migration.d.ts +6 -0
  83. package/dist/tools/background-task/index.d.ts +1 -1
  84. package/dist/tools/call-omo-agent/constants.d.ts +1 -1
  85. package/dist/tools/index.d.ts +1 -0
  86. package/dist/tools/sisyphus-task/constants.d.ts +12 -0
  87. package/dist/tools/sisyphus-task/index.d.ts +3 -0
  88. package/dist/tools/sisyphus-task/tools.d.ts +16 -0
  89. package/dist/tools/sisyphus-task/tools.test.d.ts +1 -0
  90. package/dist/tools/sisyphus-task/types.d.ts +9 -0
  91. package/dist/tools/slashcommand/types.d.ts +2 -1
  92. package/package.json +3 -2
  93. 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.7"
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-Sisyphus**: OpenCode のデフォルトプランエージェント(SDK 制限により名前変更、デフォルトで有効)
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-Sisyphus": {
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-Sisyphus エージェントを有効化します(OpenCode plan と同じ、SDK 制限により名前変更)。デフォルトで有効です。 |
907
- | `replace_plan` | `true` | `true` の場合、デフォルトのプランエージェントをサブエージェントモードに降格させます。`false` に設定すると、Planner-Sisyphus とデフォルトのプランの両方を利用できます。 |
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
  [![GitHub Issues](https://img.shields.io/github/issues/code-yeongyu/oh-my-opencode?color=ff80eb&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/issues)
42
43
  [![License](https://img.shields.io/badge/license-SUL--1.0-white?labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/blob/master/LICENSE.md)
43
44
 
44
- [English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.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 the setup.](#step-0-ask-user-about-the-setup)
88
- - [Step 1: Install OpenCode, if not](#step-1-install-opencode-if-not)
89
- - [Step 2: Configure oh-my-opencode Plugin](#step-2-configure-oh-my-opencode-plugin)
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.7"
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 | User Config Path |
748
- |----------|------------------|
749
- | **Windows** | `~/.config/opencode/oh-my-opencode.json` (preferred) or `%APPDATA%\opencode\oh-my-opencode.json` (fallback) |
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-Sisyphus**: OpenCode's default plan agent, renamed due to SDK limitations (enabled by default)
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-Sisyphus": {
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-Sisyphus agent (same as OpenCode plan, renamed due to SDK limitations). Enabled by default. |
968
- | `replace_plan` | `true` | When `true`, demotes default plan agent to subagent mode. Set to `false` to keep both Planner-Sisyphus and default plan available. |
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 | Default | Description |
1040
- | --------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1041
- | `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. |
1042
- | `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`. |
1043
- | `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. |
1044
- | `auto_resume` | `false` | Automatically resumes session after successful recovery from thinking block errors or thinking disabled violations. Extracts the last user message and continues. |
1045
- | `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. |
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