oh-my-opencode 2.14.0 → 3.0.0-beta.2

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 (86) hide show
  1. package/README.ja.md +76 -17
  2. package/README.md +169 -37
  3. package/README.zh-cn.md +73 -17
  4. package/dist/agents/metis.d.ts +19 -0
  5. package/dist/agents/momus.d.ts +6 -0
  6. package/dist/agents/orchestrator-sisyphus.d.ts +20 -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 +342 -117
  34. package/dist/config/schema.d.ts +473 -6
  35. package/dist/features/background-agent/manager.d.ts +13 -1
  36. package/dist/features/background-agent/types.d.ts +26 -1
  37. package/dist/features/boulder-state/constants.d.ts +10 -0
  38. package/dist/features/boulder-state/index.d.ts +3 -0
  39. package/dist/features/boulder-state/storage.d.ts +28 -0
  40. package/dist/features/boulder-state/storage.test.d.ts +1 -0
  41. package/dist/features/boulder-state/types.d.ts +24 -0
  42. package/dist/features/builtin-commands/templates/init-deep.d.ts +1 -1
  43. package/dist/features/builtin-commands/templates/refactor.d.ts +1 -1
  44. package/dist/features/builtin-commands/templates/start-work.d.ts +1 -0
  45. package/dist/features/builtin-commands/types.d.ts +1 -1
  46. package/dist/features/hook-message-injector/injector.d.ts +2 -2
  47. package/dist/features/hook-message-injector/types.d.ts +3 -2
  48. package/dist/features/opencode-skill-loader/index.d.ts +1 -0
  49. package/dist/features/opencode-skill-loader/skill-content.d.ts +5 -0
  50. package/dist/features/opencode-skill-loader/skill-content.test.d.ts +1 -0
  51. package/dist/features/task-toast-manager/index.d.ts +2 -0
  52. package/dist/features/task-toast-manager/manager.d.ts +56 -0
  53. package/dist/features/task-toast-manager/manager.test.d.ts +1 -0
  54. package/dist/features/task-toast-manager/types.d.ts +16 -0
  55. package/dist/google-auth.js +2167 -161
  56. package/dist/hooks/agent-usage-reminder/constants.d.ts +1 -1
  57. package/dist/hooks/auto-update-checker/index.d.ts +3 -0
  58. package/dist/hooks/auto-update-checker/index.test.d.ts +1 -0
  59. package/dist/hooks/claude-code-hooks/index.d.ts +2 -1
  60. package/dist/hooks/claude-code-hooks/types.d.ts +1 -0
  61. package/dist/hooks/index.d.ts +4 -0
  62. package/dist/hooks/prometheus-md-only/constants.d.ts +6 -0
  63. package/dist/hooks/prometheus-md-only/index.d.ts +12 -0
  64. package/dist/hooks/prometheus-md-only/index.test.d.ts +1 -0
  65. package/dist/hooks/sisyphus-orchestrator/index.d.ts +35 -0
  66. package/dist/hooks/sisyphus-orchestrator/index.test.d.ts +1 -0
  67. package/dist/hooks/start-work/index.d.ts +16 -0
  68. package/dist/hooks/start-work/index.test.d.ts +1 -0
  69. package/dist/hooks/task-resume-info/index.d.ts +11 -0
  70. package/dist/hooks/todo-continuation-enforcer.d.ts +1 -0
  71. package/dist/index.js +15227 -6676
  72. package/dist/mcp/index.d.ts +4 -2
  73. package/dist/mcp/websearch.d.ts +3 -0
  74. package/dist/shared/external-plugin-detector.d.ts +18 -0
  75. package/dist/shared/external-plugin-detector.test.d.ts +1 -0
  76. package/dist/shared/index.d.ts +1 -0
  77. package/dist/shared/migration.d.ts +6 -0
  78. package/dist/tools/background-task/index.d.ts +1 -1
  79. package/dist/tools/call-omo-agent/constants.d.ts +1 -1
  80. package/dist/tools/index.d.ts +1 -0
  81. package/dist/tools/sisyphus-task/constants.d.ts +12 -0
  82. package/dist/tools/sisyphus-task/index.d.ts +3 -0
  83. package/dist/tools/sisyphus-task/tools.d.ts +16 -0
  84. package/dist/tools/sisyphus-task/tools.test.d.ts +1 -0
  85. package/dist/tools/sisyphus-task/types.d.ts +9 -0
  86. package/package.json +3 -2
package/README.ja.md CHANGED
@@ -1,9 +1,12 @@
1
1
  > [!NOTE]
2
2
  >
3
- > *「私はエージェントが生成したコードと人間が書いたコードを区別できない、しかしはるかに多くのことを達成できる世界を作り、ソフトウェア革命を起こすことを目指しています。私はこの旅に個人的な時間、情熱、そして資金を注ぎ込んできましたし、これからもそうし続けます。」*
3
+ > [![Sisyphus Labs — Sisyphus is the agent that codes like your team.](./.github/assets/sisyphuslabs.png?v=2)](https://sisyphuslabs.ai)
4
+ > > **Sisyphusの完全製品化バージョンを構築中です。フロンティアエージェントの未来を定義します。<br />[こちら](https://sisyphuslabs.ai)からウェイトリストに参加してください。**
5
+
6
+ > [!TIP]
4
7
  >
5
- > [![The Orchestrator is coming](./.github/assets/orchestrator-sisyphus.png)](https://x.com/justsisyphus/status/2006250634354548963)
6
- > > **オーケストレーターが来ます。今週中に。[Xで通知を受け取る](https://x.com/justsisyphus/status/2006250634354548963)**
8
+ > [![The Orchestrator is now available in beta.](./.github/assets/orchestrator-sisyphus.png?v=3)](https://github.com/code-yeongyu/oh-my-opencode/releases/tag/v3.0.0-beta.1)
9
+ > > **オーケストレーターがベータ版で利用可能になりました。`oh-my-opencode@3.0.0-beta.1`を使用してインストールしてください。**
7
10
  >
8
11
  > 一緒に歩みましょう!
9
12
  >
@@ -45,12 +48,18 @@
45
48
 
46
49
  ## ユーザーレビュー
47
50
 
51
+ > "Cursorのサブスクリプションを解約しました。オープンソースコミュニティで信じられないことが起きています。" - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
52
+
48
53
  > "人間が3ヶ月かかる仕事をClaude Codeが7日でやるなら、Sisyphusは1時間でやります。タスクが完了するまでただ動き続ける。It is a discipline agent." — B, Quant Researcher
49
54
 
50
55
  > "Oh My Opencodeを使って、たった1日で8000個のeslint警告を解消しました" — [Jacob Ferrari](https://x.com/jacobferrari_/status/2003258761952289061)
51
56
 
52
57
  > "Ohmyopencodeとralph loopを使って、一晩で45,000行のtauriアプリをSaaSウェブアプリに変換しました。インタビュープロンプトから始めて、質問に対する評価と推奨を求めました。作業する様子を見ているのは驚きでしたし、朝起きたらほぼ完成したウェブサイトがありました!" - [James Hargis](https://x.com/hargabyte/status/2007299688261882202)
53
58
 
59
+ > "oh-my-opencodeを使ってください、もう戻れませんよ" — [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
60
+
61
+ > "何どうすごいのかあまり言語化できてないけど、開発体験が異次元に上がった。" - [苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
62
+
54
63
  > "今週末はopen code、oh my opencode、supermemoryでマインクラフト/ソウルライクな何かを作る実験をしています。"
55
64
  > "昼食後の散歩に行く間に、しゃがみアニメーションを追加するよう頼みました。[動画]" - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
56
65
 
@@ -58,16 +67,8 @@
58
67
 
59
68
  > "@yeon_gyu_kimを説得できるなら雇うべきです。彼はopencodeに革命を起こしました" — [mysticaltech](https://x.com/mysticaltech/status/2001858758608376079)
60
69
 
61
- > "やばい、これマジで本物だ @androolloyd oh my opencode 最高すぎる" — [z80.eth](https://x.com/0xz80/status/2001815226505924791)
62
-
63
- > "oh-my-opencodeを使ってください、もう戻れませんよ" — [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
64
-
65
- > "Oh My Opencodeは頂点に立っています、敵はいません" — [RyanOnThePath](https://x.com/RyanOnThePath/status/2001438321252118548)
66
-
67
70
  > "Oh My OpenCode Is Actually Insane" - [YouTube - Darren Builds AI](https://www.youtube.com/watch?v=G_Snfh2M41M)
68
71
 
69
- > "シジフォスという名前自体が美しいじゃないですか?" — Sigrid ([@sigridjin_eth](https://x.com/sigridjin_eth))
70
-
71
72
  ---
72
73
 
73
74
  ## 目次
@@ -208,6 +209,9 @@ Windows から Linux に初めて乗り換えた時のこと、自分の思い
208
209
  ### 人間の方へ
209
210
 
210
211
  面倒な作業は LLM エージェントに任せましょう。このリンクをコピーして貼り付け、インストールと設定をお願いしてください。
212
+ ```
213
+ Install and configure by following the instructions here https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/README.md
214
+ ```
211
215
 
212
216
  ### LLM エージェントの方へ
213
217
 
@@ -300,7 +304,7 @@ opencode auth login
300
304
  {
301
305
  "plugin": [
302
306
  "oh-my-opencode",
303
- "opencode-antigravity-auth@1.2.7"
307
+ "opencode-antigravity-auth@1.2.8"
304
308
  ]
305
309
  }
306
310
  ```
@@ -643,7 +647,8 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
643
647
  "commands": false,
644
648
  "skills": false,
645
649
  "agents": false,
646
- "hooks": false
650
+ "hooks": false,
651
+ "plugins": false
647
652
  }
648
653
  }
649
654
  ```
@@ -655,9 +660,25 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
655
660
  | `skills` | `~/.claude/skills/*/SKILL.md`, `./.claude/skills/*/SKILL.md` | - |
656
661
  | `agents` | `~/.claude/agents/*.md`, `./.claude/agents/*.md` | 内蔵エージェント (oracle, librarian 等) |
657
662
  | `hooks` | `~/.claude/settings.json`, `./.claude/settings.json`, `./.claude/settings.local.json` | - |
663
+ | `plugins` | `~/.claude/plugins/` (Claude Code マーケットプレイスプラグイン) | - |
658
664
 
659
665
  すべてのトグルはデフォルトで `true` (有効) です。完全な Claude Code 互換性を望む場合は `claude_code` オブジェクトを省略してください。
660
666
 
667
+ **特定のプラグインだけを無効化** するには `plugins_override` を使用します:
668
+
669
+ ```json
670
+ {
671
+ "claude_code": {
672
+ "plugins_override": {
673
+ "claude-mem@thedotmack": false,
674
+ "some-other-plugin@marketplace": false
675
+ }
676
+ }
677
+ }
678
+ ```
679
+
680
+ プラグインシステム自体は有効にしたまま、特定のプラグインだけをその完全な識別子 (`plugin-name@marketplace-name`) で無効化できます。
681
+
661
682
  ### エージェントのためだけでなく、あなたのために
662
683
 
663
684
  エージェントが活躍すれば、あなたも幸せになります。ですが、私はあなた自身も助けたいのです。
@@ -844,7 +865,8 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
844
865
 
845
866
  - **Sisyphus**: プライマリオーケストレーターエージェント (Claude Opus 4.5)
846
867
  - **OpenCode-Builder**: OpenCode のデフォルトビルドエージェント(SDK 制限により名前変更、デフォルトで無効)
847
- - **Planner-Sisyphus**: OpenCode のデフォルトプランエージェント(SDK 制限により名前変更、デフォルトで有効)
868
+ - **Prometheus (Planner)**: OpenCode のデフォルトプランエージェント + work-planner 方法論(デフォルトで有効)
869
+ - **Metis (Plan Consultant)**: 隠された要件と AI 失敗ポイントを特定する事前計画分析エージェント
848
870
 
849
871
  **設定オプション:**
850
872
 
@@ -893,8 +915,11 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
893
915
  "OpenCode-Builder": {
894
916
  "model": "anthropic/claude-opus-4"
895
917
  },
896
- "Planner-Sisyphus": {
918
+ "Prometheus (Planner)": {
897
919
  "model": "openai/gpt-5.2"
920
+ },
921
+ "Metis (Plan Consultant)": {
922
+ "model": "anthropic/claude-sonnet-4-5"
898
923
  }
899
924
  }
900
925
  }
@@ -904,8 +929,42 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
904
929
  | --------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
905
930
  | `disabled` | `false` | `true` の場合、すべての Sisyphus オーケストレーションを無効化し、元の build/plan をプライマリとして復元します。 |
906
931
  | `default_builder_enabled` | `false` | `true` の場合、OpenCode-Builder エージェントを有効化します(OpenCode build と同じ、SDK 制限により名前変更)。デフォルトでは無効です。 |
907
- | `planner_enabled` | `true` | `true` の場合、Planner-Sisyphus エージェントを有効化します(OpenCode plan と同じ、SDK 制限により名前変更)。デフォルトで有効です。 |
908
- | `replace_plan` | `true` | `true` の場合、デフォルトのプランエージェントをサブエージェントモードに降格させます。`false` に設定すると、Planner-Sisyphus とデフォルトのプランの両方を利用できます。 |
932
+ | `planner_enabled` | `true` | `true` の場合、Prometheus (Planner) エージェントを有効化します(work-planner 方法論を含む)。デフォルトで有効です。 |
933
+ | `replace_plan` | `true` | `true` の場合、デフォルトのプランエージェントをサブエージェントモードに降格させます。`false` に設定すると、Prometheus (Planner) とデフォルトのプランの両方を利用できます。 |
934
+
935
+ ### Background Tasks
936
+
937
+ バックグラウンドエージェントタスクの同時実行数を設定します。並列で実行できるバックグラウンドエージェントの数を制御します。
938
+
939
+ ```json
940
+ {
941
+ "background_task": {
942
+ "defaultConcurrency": 5,
943
+ "providerConcurrency": {
944
+ "anthropic": 3,
945
+ "openai": 5,
946
+ "google": 10
947
+ },
948
+ "modelConcurrency": {
949
+ "anthropic/claude-opus-4-5": 2,
950
+ "google/gemini-3-flash": 10
951
+ }
952
+ }
953
+ }
954
+ ```
955
+
956
+ | オプション | デフォルト | 説明 |
957
+ | --------------------- | ---------- | -------------------------------------------------------------------------------------------------------------- |
958
+ | `defaultConcurrency` | - | すべてのプロバイダー/モデルに対するデフォルトの最大同時バックグラウンドタスク数 |
959
+ | `providerConcurrency` | - | プロバイダーごとの同時実行制限。キーはプロバイダー名(例:`anthropic`、`openai`、`google`) |
960
+ | `modelConcurrency` | - | モデルごとの同時実行制限。キーは完全なモデル名(例:`anthropic/claude-opus-4-5`)。プロバイダー制限より優先されます。 |
961
+
962
+ **優先順位**: `modelConcurrency` > `providerConcurrency` > `defaultConcurrency`
963
+
964
+ **ユースケース**:
965
+ - 高価なモデル(例:Opus)を制限してコストの急増を防ぐ
966
+ - 高速で安価なモデル(例:Gemini Flash)により多くの同時タスクを許可する
967
+ - プロバイダーレベルの上限を設定してプロバイダーのレートリミットを遵守する
909
968
 
910
969
  ### Hooks
911
970
 
package/README.md CHANGED
@@ -1,9 +1,12 @@
1
1
  > [!NOTE]
2
2
  >
3
- > *"I aim to spark a software revolution by creating a world where agent-generated code is indistinguishable from human code, yet capable of achieving vastly more. I have poured my personal time, passion, and funds into this journey, and I will continue to do so."*
3
+ > [![Sisyphus Labs Sisyphus is the agent that codes like your team.](./.github/assets/sisyphuslabs.png?v=2)](https://sisyphuslabs.ai)
4
+ > > **We're building a fully productized version of Sisyphus to define the future of frontier agents. <br />Join the waitlist [here](https://sisyphuslabs.ai).**
5
+
6
+ > [!TIP]
4
7
  >
5
- > [![The Orchestrator is coming](./.github/assets/orchestrator-sisyphus.png)](https://x.com/justsisyphus/status/2006250634354548963)
6
- > > **The Orchestrator is coming. This Week. [Get notified on X](https://x.com/justsisyphus/status/2006250634354548963)**
8
+ > [![The Orchestrator is now available in beta.](./.github/assets/orchestrator-sisyphus.png?v=3)](https://github.com/code-yeongyu/oh-my-opencode/releases/tag/v3.0.0-beta.1)
9
+ > > **The Orchestrator is now available in beta. Use `oh-my-opencode@3.0.0-beta.1` to install it.**
7
10
  >
8
11
  > Be with us!
9
12
  >
@@ -50,12 +53,19 @@ No stupid token consumption massive subagents here. No bloat tools here.
50
53
 
51
54
  ## Reviews
52
55
 
56
+ > "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)
57
+
53
58
  > "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
54
59
 
55
60
  > "Knocked out 8000 eslint warnings with Oh My Opencode, just in a day" — [Jacob Ferrari](https://x.com/jacobferrari_/status/2003258761952289061)
56
61
 
57
62
  > "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)
58
63
 
64
+ > "use oh-my-opencode, you will never go back" — [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
65
+
66
+ > "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." - [
67
+ 苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
68
+
59
69
  > "Experimenting with open code, oh my opencode and supermemory this weekend to build some minecraft/souls-like abomination."
60
70
  > "Asking it to add crouch animations while I go take my post-lunch walk. [Video]" - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
61
71
 
@@ -63,15 +73,7 @@ No stupid token consumption massive subagents here. No bloat tools here.
63
73
 
64
74
  > "Hire @yeon_gyu_kim if you can convince him, this dude has revolutionized opencode." — [mysticaltech](https://x.com/mysticaltech/status/2001858758608376079)
65
75
 
66
- > "ok yeah holy shit @androolloyd this thing is legit oh my opencode is sick" — [z80.eth](https://x.com/0xz80/status/2001815226505924791)
67
-
68
- > "use oh-my-opencode, you will never go back" — [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
69
-
70
- > "Oh My Opencode is king of the hill and has no contenders" — [RyanOnThePath](https://x.com/RyanOnThePath/status/2001438321252118548)
71
-
72
76
  > "Oh My OpenCode Is Actually Insane" - [YouTube - Darren Builds AI](https://www.youtube.com/watch?v=G_Snfh2M41M)
73
- >
74
- > "Isn't the name Sisyphus beautiful by itself?" — Sigrid ([@sigridjin_eth](https://x.com/sigridjin_eth))
75
77
 
76
78
  ---
77
79
 
@@ -80,25 +82,28 @@ No stupid token consumption massive subagents here. No bloat tools here.
80
82
  - [Oh My OpenCode](#oh-my-opencode)
81
83
  - [Just Skip Reading This Readme](#just-skip-reading-this-readme)
82
84
  - [It's the Age of Agents](#its-the-age-of-agents)
85
+ - [🪄 The Magic Word: `ultrawork`](#-the-magic-word-ultrawork)
83
86
  - [For Those Who Want to Read: Meet Sisyphus](#for-those-who-want-to-read-meet-sisyphus)
84
87
  - [Just Install It.](#just-install-it)
85
88
  - [Installation](#installation)
86
89
  - [For Humans](#for-humans)
87
90
  - [For LLM Agents](#for-llm-agents)
88
- - [Step 0: Ask user about the setup.](#step-0-ask-user-about-the-setup)
89
- - [Step 1: Install OpenCode, if not](#step-1-install-opencode-if-not)
90
- - [Step 2: Configure oh-my-opencode Plugin](#step-2-configure-oh-my-opencode-plugin)
91
- - [JSONC](#jsonc)
92
- - [JSON](#json)
91
+ - [Step 0: Ask user about subscriptions](#step-0-ask-user-about-subscriptions)
92
+ - [Step 1: Install OpenCode (if not installed)](#step-1-install-opencode-if-not-installed)
93
+ - [Step 2: Run the installer](#step-2-run-the-installer)
93
94
  - [Step 3: Verify Setup](#step-3-verify-setup)
94
95
  - [Step 4: Configure Authentication](#step-4-configure-authentication)
95
96
  - [Anthropic (Claude)](#anthropic-claude)
96
97
  - [Google Gemini (Antigravity OAuth)](#google-gemini-antigravity-oauth)
97
- - [OpenAI (ChatGPT Plus/Pro)](#openai-chatgpt-pluspro)
98
98
  - [Model Configuration](#model-configuration)
99
+ - [oh-my-opencode Agent Model Override](#oh-my-opencode-agent-model-override)
100
+ - [OpenAI (ChatGPT Plus/Pro)](#openai-chatgpt-pluspro)
101
+ - [Model Configuration](#model-configuration-1)
99
102
  - [⚠️ Warning](#️-warning)
100
103
  - [Verify the setup](#verify-the-setup)
101
104
  - [Say 'Congratulations! 🎉' to the user](#say-congratulations--to-the-user)
105
+ - [Free advertising](#free-advertising)
106
+ - [Ask for a Star ⭐](#ask-for-a-star-)
102
107
  - [Too Complicated?](#too-complicated)
103
108
  - [Uninstallation](#uninstallation)
104
109
  - [Features](#features)
@@ -106,9 +111,11 @@ No stupid token consumption massive subagents here. No bloat tools here.
106
111
  - [Background Agents: Work Like a Team](#background-agents-work-like-a-team)
107
112
  - [The Tools: Your Teammates Deserve Better](#the-tools-your-teammates-deserve-better)
108
113
  - [Why Are You the Only One Using an IDE?](#why-are-you-the-only-one-using-an-ide)
114
+ - [Session Management](#session-management)
109
115
  - [Context Is All You Need](#context-is-all-you-need)
110
116
  - [Be Multimodal. Save Tokens.](#be-multimodal-save-tokens)
111
117
  - [I Removed Their Blockers](#i-removed-their-blockers)
118
+ - [Skill-Embedded MCP Support](#skill-embedded-mcp-support)
112
119
  - [Goodbye Claude Code. Hello Oh My OpenCode.](#goodbye-claude-code-hello-oh-my-opencode)
113
120
  - [Hooks Integration](#hooks-integration)
114
121
  - [Config Loaders](#config-loaders)
@@ -116,16 +123,22 @@ No stupid token consumption massive subagents here. No bloat tools here.
116
123
  - [Compatibility Toggles](#compatibility-toggles)
117
124
  - [Not Just for the Agents](#not-just-for-the-agents)
118
125
  - [Configuration](#configuration)
126
+ - [JSONC Support](#jsonc-support)
119
127
  - [Google Auth](#google-auth)
120
128
  - [Agents](#agents)
121
129
  - [Permission Options](#permission-options)
130
+ - [Built-in Skills](#built-in-skills)
122
131
  - [Sisyphus Agent](#sisyphus-agent)
132
+ - [Background Tasks](#background-tasks)
133
+ - [Categories](#categories)
123
134
  - [Hooks](#hooks)
124
135
  - [MCPs](#mcps)
125
136
  - [LSP](#lsp)
126
137
  - [Experimental](#experimental)
127
138
  - [Author's Note](#authors-note)
128
139
  - [Warnings](#warnings)
140
+ - [Loved by professionals at](#loved-by-professionals-at)
141
+ - [Sponsors](#sponsors)
129
142
 
130
143
  # Oh My OpenCode
131
144
 
@@ -330,7 +343,7 @@ First, add the opencode-antigravity-auth plugin:
330
343
  {
331
344
  "plugin": [
332
345
  "oh-my-opencode",
333
- "opencode-antigravity-auth@1.2.7"
346
+ "opencode-antigravity-auth@1.2.8"
334
347
  ]
335
348
  }
336
349
  ```
@@ -544,6 +557,7 @@ Hand your best tools to your best colleagues. Now they can properly refactor, na
544
557
  - **ast_grep_search**: AST-aware code pattern search (25 languages)
545
558
  - **ast_grep_replace**: AST-aware code replacement
546
559
  - **call_omo_agent**: Spawn specialized explore/librarian agents. Supports `run_in_background` parameter for async execution.
560
+ - **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).
547
561
 
548
562
  #### Session Management
549
563
 
@@ -689,7 +703,8 @@ Disable specific Claude Code compatibility features with the `claude_code` confi
689
703
  "commands": false,
690
704
  "skills": false,
691
705
  "agents": false,
692
- "hooks": false
706
+ "hooks": false,
707
+ "plugins": false
693
708
  }
694
709
  }
695
710
  ```
@@ -701,9 +716,25 @@ Disable specific Claude Code compatibility features with the `claude_code` confi
701
716
  | `skills` | `~/.claude/skills/*/SKILL.md`, `./.claude/skills/*/SKILL.md` | - |
702
717
  | `agents` | `~/.claude/agents/*.md`, `./.claude/agents/*.md` | Built-in agents (oracle, librarian, etc.) |
703
718
  | `hooks` | `~/.claude/settings.json`, `./.claude/settings.json`, `./.claude/settings.local.json` | - |
719
+ | `plugins` | `~/.claude/plugins/` (Claude Code marketplace plugins) | - |
704
720
 
705
721
  All toggles default to `true` (enabled). Omit the `claude_code` object for full Claude Code compatibility.
706
722
 
723
+ **Selectively disable specific plugins** using `plugins_override`:
724
+
725
+ ```json
726
+ {
727
+ "claude_code": {
728
+ "plugins_override": {
729
+ "claude-mem@thedotmack": false,
730
+ "some-other-plugin@marketplace": false
731
+ }
732
+ }
733
+ }
734
+ ```
735
+
736
+ This allows you to keep the plugin system enabled while disabling specific plugins by their full identifier (`plugin-name@marketplace-name`).
737
+
707
738
  ### Not Just for the Agents
708
739
 
709
740
  When agents thrive, you thrive. But I want to help you directly too.
@@ -746,10 +777,10 @@ Config file locations (priority order):
746
777
  1. `.opencode/oh-my-opencode.json` (project)
747
778
  2. User config (platform-specific):
748
779
 
749
- | Platform | User Config Path |
750
- |----------|------------------|
751
- | **Windows** | `~/.config/opencode/oh-my-opencode.json` (preferred) or `%APPDATA%\opencode\oh-my-opencode.json` (fallback) |
752
- | **macOS/Linux** | `~/.config/opencode/oh-my-opencode.json` |
780
+ | Platform | User Config Path |
781
+ | --------------- | ----------------------------------------------------------------------------------------------------------- |
782
+ | **Windows** | `~/.config/opencode/oh-my-opencode.json` (preferred) or `%APPDATA%\opencode\oh-my-opencode.json` (fallback) |
783
+ | **macOS/Linux** | `~/.config/opencode/oh-my-opencode.json` |
753
784
 
754
785
  Schema autocomplete supported:
755
786
 
@@ -773,10 +804,10 @@ When both `oh-my-opencode.jsonc` and `oh-my-opencode.json` files exist, `.jsonc`
773
804
  ```jsonc
774
805
  {
775
806
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
776
-
807
+
777
808
  // Enable Google Gemini via Antigravity OAuth
778
809
  "google_auth": false,
779
-
810
+
780
811
  /* Agent overrides - customize models for specific tasks */
781
812
  "agents": {
782
813
  "oracle": {
@@ -889,6 +920,7 @@ Available agents: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `
889
920
  Oh My OpenCode includes built-in skills that provide additional capabilities:
890
921
 
891
922
  - **playwright**: Browser automation with Playwright MCP. Use for web scraping, testing, screenshots, and browser interactions.
923
+ - **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.
892
924
 
893
925
  Disable built-in skills via `disabled_skills` in `~/.config/opencode/oh-my-opencode.json` or `.opencode/oh-my-opencode.json`:
894
926
 
@@ -898,7 +930,25 @@ Disable built-in skills via `disabled_skills` in `~/.config/opencode/oh-my-openc
898
930
  }
899
931
  ```
900
932
 
901
- Available built-in skills: `playwright`
933
+ Available built-in skills: `playwright`, `git-master`
934
+
935
+ ### Git Master
936
+
937
+ Configure git-master skill behavior:
938
+
939
+ ```json
940
+ {
941
+ "git_master": {
942
+ "commit_footer": true,
943
+ "include_co_authored_by": true
944
+ }
945
+ }
946
+ ```
947
+
948
+ | Option | Default | Description |
949
+ | ------ | ------- | ----------- |
950
+ | `commit_footer` | `true` | Adds "Ultraworked with Sisyphus" footer to commit messages. |
951
+ | `include_co_authored_by` | `true` | Adds `Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>` trailer to commits. |
902
952
 
903
953
  ### Sisyphus Agent
904
954
 
@@ -906,7 +956,8 @@ When enabled (default), Sisyphus provides a powerful orchestrator with optional
906
956
 
907
957
  - **Sisyphus**: Primary orchestrator agent (Claude Opus 4.5)
908
958
  - **OpenCode-Builder**: OpenCode's default build agent, renamed due to SDK limitations (disabled by default)
909
- - **Planner-Sisyphus**: OpenCode's default plan agent, renamed due to SDK limitations (enabled by default)
959
+ - **Prometheus (Planner)**: OpenCode's default plan agent with work-planner methodology (enabled by default)
960
+ - **Metis (Plan Consultant)**: Pre-planning analysis agent that identifies hidden requirements and AI failure points
910
961
 
911
962
  **Configuration Options:**
912
963
 
@@ -955,8 +1006,11 @@ You can also customize Sisyphus agents like other agents:
955
1006
  "OpenCode-Builder": {
956
1007
  "model": "anthropic/claude-opus-4"
957
1008
  },
958
- "Planner-Sisyphus": {
1009
+ "Prometheus (Planner)": {
959
1010
  "model": "openai/gpt-5.2"
1011
+ },
1012
+ "Metis (Plan Consultant)": {
1013
+ "model": "anthropic/claude-sonnet-4-5"
960
1014
  }
961
1015
  }
962
1016
  }
@@ -966,8 +1020,86 @@ You can also customize Sisyphus agents like other agents:
966
1020
  | --------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
967
1021
  | `disabled` | `false` | When `true`, disables all Sisyphus orchestration and restores original build/plan as primary. |
968
1022
  | `default_builder_enabled` | `false` | When `true`, enables OpenCode-Builder agent (same as OpenCode build, renamed due to SDK limitations). Disabled by default. |
969
- | `planner_enabled` | `true` | When `true`, enables Planner-Sisyphus agent (same as OpenCode plan, renamed due to SDK limitations). Enabled by default. |
970
- | `replace_plan` | `true` | When `true`, demotes default plan agent to subagent mode. Set to `false` to keep both Planner-Sisyphus and default plan available. |
1023
+ | `planner_enabled` | `true` | When `true`, enables Prometheus (Planner) agent with work-planner methodology. Enabled by default. |
1024
+ | `replace_plan` | `true` | When `true`, demotes default plan agent to subagent mode. Set to `false` to keep both Prometheus (Planner) and default plan available. |
1025
+
1026
+ ### Background Tasks
1027
+
1028
+ Configure concurrency limits for background agent tasks. This controls how many parallel background agents can run simultaneously.
1029
+
1030
+ ```json
1031
+ {
1032
+ "background_task": {
1033
+ "defaultConcurrency": 5,
1034
+ "providerConcurrency": {
1035
+ "anthropic": 3,
1036
+ "openai": 5,
1037
+ "google": 10
1038
+ },
1039
+ "modelConcurrency": {
1040
+ "anthropic/claude-opus-4-5": 2,
1041
+ "google/gemini-3-flash": 10
1042
+ }
1043
+ }
1044
+ }
1045
+ ```
1046
+
1047
+ | Option | Default | Description |
1048
+ | --------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------- |
1049
+ | `defaultConcurrency` | - | Default maximum concurrent background tasks for all providers/models |
1050
+ | `providerConcurrency` | - | Per-provider concurrency limits. Keys are provider names (e.g., `anthropic`, `openai`, `google`) |
1051
+ | `modelConcurrency` | - | Per-model concurrency limits. Keys are full model names (e.g., `anthropic/claude-opus-4-5`). Overrides provider limits. |
1052
+
1053
+ **Priority Order**: `modelConcurrency` > `providerConcurrency` > `defaultConcurrency`
1054
+
1055
+ **Use Cases**:
1056
+ - Limit expensive models (e.g., Opus) to prevent cost spikes
1057
+ - Allow more concurrent tasks for fast/cheap models (e.g., Gemini Flash)
1058
+ - Respect provider rate limits by setting provider-level caps
1059
+
1060
+ ### Categories
1061
+
1062
+ 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.
1063
+
1064
+ **Default Categories:**
1065
+
1066
+ | Category | Model | Description |
1067
+ |----------|-------|-------------|
1068
+ | `visual` | `google/gemini-3-pro-preview` | Frontend, UI/UX, design-focused tasks. High creativity (temp 0.7). |
1069
+ | `business-logic` | `openai/gpt-5.2` | Backend logic, architecture, strategic reasoning. Low creativity (temp 0.1). |
1070
+
1071
+ **Usage:**
1072
+
1073
+ ```
1074
+ // Via sisyphus_task tool
1075
+ sisyphus_task(category="visual", prompt="Create a responsive dashboard component")
1076
+ sisyphus_task(category="business-logic", prompt="Design the payment processing flow")
1077
+
1078
+ // Or target a specific agent directly
1079
+ sisyphus_task(agent="oracle", prompt="Review this architecture")
1080
+ ```
1081
+
1082
+ **Custom Categories:**
1083
+
1084
+ Add custom categories in `oh-my-opencode.json`:
1085
+
1086
+ ```json
1087
+ {
1088
+ "categories": {
1089
+ "data-science": {
1090
+ "model": "anthropic/claude-sonnet-4-5",
1091
+ "temperature": 0.2,
1092
+ "prompt_append": "Focus on data analysis, ML pipelines, and statistical methods."
1093
+ },
1094
+ "visual": {
1095
+ "model": "google/gemini-3-pro-high",
1096
+ "prompt_append": "Use shadcn/ui components and Tailwind CSS."
1097
+ }
1098
+ }
1099
+ }
1100
+ ```
1101
+
1102
+ Each category supports: `model`, `temperature`, `top_p`, `maxTokens`, `thinking`, `reasoningEffort`, `textVerbosity`, `tools`, `prompt_append`.
971
1103
 
972
1104
  ### Hooks
973
1105
 
@@ -1039,13 +1171,13 @@ Opt-in experimental features that may change or be removed in future versions. U
1039
1171
  }
1040
1172
  ```
1041
1173
 
1042
- | Option | Default | Description |
1043
- | --------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1044
- | `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. |
1045
- | `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`. |
1046
- | `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. |
1047
- | `auto_resume` | `false` | Automatically resumes session after successful recovery from thinking block errors or thinking disabled violations. Extracts the last user message and continues. |
1048
- | `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. |
1174
+ | Option | Default | Description |
1175
+ | --------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1176
+ | `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. |
1177
+ | `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`. |
1178
+ | `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. |
1179
+ | `auto_resume` | `false` | Automatically resumes session after successful recovery from thinking block errors or thinking disabled violations. Extracts the last user message and continues. |
1180
+ | `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. |
1049
1181
 
1050
1182
  **Warning**: These features are experimental and may cause unexpected behavior. Enable only if you understand the implications.
1051
1183