oh-my-opencode 2.14.0 → 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 (84) hide show
  1. package/README.ja.md +70 -14
  2. package/README.md +163 -34
  3. package/README.zh-cn.md +67 -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 +334 -115
  34. package/dist/config/schema.d.ts +269 -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/claude-code-hooks/index.d.ts +2 -1
  58. package/dist/hooks/claude-code-hooks/types.d.ts +1 -0
  59. package/dist/hooks/index.d.ts +4 -0
  60. package/dist/hooks/prometheus-md-only/constants.d.ts +6 -0
  61. package/dist/hooks/prometheus-md-only/index.d.ts +12 -0
  62. package/dist/hooks/prometheus-md-only/index.test.d.ts +1 -0
  63. package/dist/hooks/sisyphus-orchestrator/index.d.ts +35 -0
  64. package/dist/hooks/sisyphus-orchestrator/index.test.d.ts +1 -0
  65. package/dist/hooks/start-work/index.d.ts +16 -0
  66. package/dist/hooks/start-work/index.test.d.ts +1 -0
  67. package/dist/hooks/task-resume-info/index.d.ts +11 -0
  68. package/dist/hooks/todo-continuation-enforcer.d.ts +1 -0
  69. package/dist/index.js +12017 -3545
  70. package/dist/mcp/index.d.ts +4 -2
  71. package/dist/mcp/websearch.d.ts +3 -0
  72. package/dist/shared/external-plugin-detector.d.ts +18 -0
  73. package/dist/shared/external-plugin-detector.test.d.ts +1 -0
  74. package/dist/shared/index.d.ts +1 -0
  75. package/dist/shared/migration.d.ts +6 -0
  76. package/dist/tools/background-task/index.d.ts +1 -1
  77. package/dist/tools/call-omo-agent/constants.d.ts +1 -1
  78. package/dist/tools/index.d.ts +1 -0
  79. package/dist/tools/sisyphus-task/constants.d.ts +12 -0
  80. package/dist/tools/sisyphus-task/index.d.ts +3 -0
  81. package/dist/tools/sisyphus-task/tools.d.ts +16 -0
  82. package/dist/tools/sisyphus-task/tools.test.d.ts +1 -0
  83. package/dist/tools/sisyphus-task/types.d.ts +9 -0
  84. package/package.json +3 -2
package/README.ja.md CHANGED
@@ -45,12 +45,18 @@
45
45
 
46
46
  ## ユーザーレビュー
47
47
 
48
+ > "Cursorのサブスクリプションを解約しました。オープンソースコミュニティで信じられないことが起きています。" - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
49
+
48
50
  > "人間が3ヶ月かかる仕事をClaude Codeが7日でやるなら、Sisyphusは1時間でやります。タスクが完了するまでただ動き続ける。It is a discipline agent." — B, Quant Researcher
49
51
 
50
52
  > "Oh My Opencodeを使って、たった1日で8000個のeslint警告を解消しました" — [Jacob Ferrari](https://x.com/jacobferrari_/status/2003258761952289061)
51
53
 
52
54
  > "Ohmyopencodeとralph loopを使って、一晩で45,000行のtauriアプリをSaaSウェブアプリに変換しました。インタビュープロンプトから始めて、質問に対する評価と推奨を求めました。作業する様子を見ているのは驚きでしたし、朝起きたらほぼ完成したウェブサイトがありました!" - [James Hargis](https://x.com/hargabyte/status/2007299688261882202)
53
55
 
56
+ > "oh-my-opencodeを使ってください、もう戻れませんよ" — [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
57
+
58
+ > "何どうすごいのかあまり言語化できてないけど、開発体験が異次元に上がった。" - [苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
59
+
54
60
  > "今週末はopen code、oh my opencode、supermemoryでマインクラフト/ソウルライクな何かを作る実験をしています。"
55
61
  > "昼食後の散歩に行く間に、しゃがみアニメーションを追加するよう頼みました。[動画]" - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
56
62
 
@@ -58,16 +64,8 @@
58
64
 
59
65
  > "@yeon_gyu_kimを説得できるなら雇うべきです。彼はopencodeに革命を起こしました" — [mysticaltech](https://x.com/mysticaltech/status/2001858758608376079)
60
66
 
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
67
  > "Oh My OpenCode Is Actually Insane" - [YouTube - Darren Builds AI](https://www.youtube.com/watch?v=G_Snfh2M41M)
68
68
 
69
- > "シジフォスという名前自体が美しいじゃないですか?" — Sigrid ([@sigridjin_eth](https://x.com/sigridjin_eth))
70
-
71
69
  ---
72
70
 
73
71
  ## 目次
@@ -208,6 +206,9 @@ Windows から Linux に初めて乗り換えた時のこと、自分の思い
208
206
  ### 人間の方へ
209
207
 
210
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
+ ```
211
212
 
212
213
  ### LLM エージェントの方へ
213
214
 
@@ -300,7 +301,7 @@ opencode auth login
300
301
  {
301
302
  "plugin": [
302
303
  "oh-my-opencode",
303
- "opencode-antigravity-auth@1.2.7"
304
+ "opencode-antigravity-auth@1.2.8"
304
305
  ]
305
306
  }
306
307
  ```
@@ -643,7 +644,8 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
643
644
  "commands": false,
644
645
  "skills": false,
645
646
  "agents": false,
646
- "hooks": false
647
+ "hooks": false,
648
+ "plugins": false
647
649
  }
648
650
  }
649
651
  ```
@@ -655,9 +657,25 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
655
657
  | `skills` | `~/.claude/skills/*/SKILL.md`, `./.claude/skills/*/SKILL.md` | - |
656
658
  | `agents` | `~/.claude/agents/*.md`, `./.claude/agents/*.md` | 内蔵エージェント (oracle, librarian 等) |
657
659
  | `hooks` | `~/.claude/settings.json`, `./.claude/settings.json`, `./.claude/settings.local.json` | - |
660
+ | `plugins` | `~/.claude/plugins/` (Claude Code マーケットプレイスプラグイン) | - |
658
661
 
659
662
  すべてのトグルはデフォルトで `true` (有効) です。完全な Claude Code 互換性を望む場合は `claude_code` オブジェクトを省略してください。
660
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
+
661
679
  ### エージェントのためだけでなく、あなたのために
662
680
 
663
681
  エージェントが活躍すれば、あなたも幸せになります。ですが、私はあなた自身も助けたいのです。
@@ -844,7 +862,8 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
844
862
 
845
863
  - **Sisyphus**: プライマリオーケストレーターエージェント (Claude Opus 4.5)
846
864
  - **OpenCode-Builder**: OpenCode のデフォルトビルドエージェント(SDK 制限により名前変更、デフォルトで無効)
847
- - **Planner-Sisyphus**: OpenCode のデフォルトプランエージェント(SDK 制限により名前変更、デフォルトで有効)
865
+ - **Prometheus (Planner)**: OpenCode のデフォルトプランエージェント + work-planner 方法論(デフォルトで有効)
866
+ - **Metis (Plan Consultant)**: 隠された要件と AI 失敗ポイントを特定する事前計画分析エージェント
848
867
 
849
868
  **設定オプション:**
850
869
 
@@ -893,8 +912,11 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
893
912
  "OpenCode-Builder": {
894
913
  "model": "anthropic/claude-opus-4"
895
914
  },
896
- "Planner-Sisyphus": {
915
+ "Prometheus (Planner)": {
897
916
  "model": "openai/gpt-5.2"
917
+ },
918
+ "Metis (Plan Consultant)": {
919
+ "model": "anthropic/claude-sonnet-4-5"
898
920
  }
899
921
  }
900
922
  }
@@ -904,8 +926,42 @@ Oh My OpenCode は以下の場所からフックを読み込んで実行しま
904
926
  | --------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
905
927
  | `disabled` | `false` | `true` の場合、すべての Sisyphus オーケストレーションを無効化し、元の build/plan をプライマリとして復元します。 |
906
928
  | `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 とデフォルトのプランの両方を利用できます。 |
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
+ - プロバイダーレベルの上限を設定してプロバイダーのレートリミットを遵守する
909
965
 
910
966
  ### Hooks
911
967
 
package/README.md CHANGED
@@ -50,12 +50,19 @@ No stupid token consumption massive subagents here. No bloat tools here.
50
50
 
51
51
  ## Reviews
52
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
+
53
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
54
56
 
55
57
  > "Knocked out 8000 eslint warnings with Oh My Opencode, just in a day" — [Jacob Ferrari](https://x.com/jacobferrari_/status/2003258761952289061)
56
58
 
57
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)
58
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
+
59
66
  > "Experimenting with open code, oh my opencode and supermemory this weekend to build some minecraft/souls-like abomination."
60
67
  > "Asking it to add crouch animations while I go take my post-lunch walk. [Video]" - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
61
68
 
@@ -63,15 +70,7 @@ No stupid token consumption massive subagents here. No bloat tools here.
63
70
 
64
71
  > "Hire @yeon_gyu_kim if you can convince him, this dude has revolutionized opencode." — [mysticaltech](https://x.com/mysticaltech/status/2001858758608376079)
65
72
 
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
73
  > "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
74
 
76
75
  ---
77
76
 
@@ -80,25 +79,28 @@ No stupid token consumption massive subagents here. No bloat tools here.
80
79
  - [Oh My OpenCode](#oh-my-opencode)
81
80
  - [Just Skip Reading This Readme](#just-skip-reading-this-readme)
82
81
  - [It's the Age of Agents](#its-the-age-of-agents)
82
+ - [🪄 The Magic Word: `ultrawork`](#-the-magic-word-ultrawork)
83
83
  - [For Those Who Want to Read: Meet Sisyphus](#for-those-who-want-to-read-meet-sisyphus)
84
84
  - [Just Install It.](#just-install-it)
85
85
  - [Installation](#installation)
86
86
  - [For Humans](#for-humans)
87
87
  - [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)
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)
93
91
  - [Step 3: Verify Setup](#step-3-verify-setup)
94
92
  - [Step 4: Configure Authentication](#step-4-configure-authentication)
95
93
  - [Anthropic (Claude)](#anthropic-claude)
96
94
  - [Google Gemini (Antigravity OAuth)](#google-gemini-antigravity-oauth)
97
- - [OpenAI (ChatGPT Plus/Pro)](#openai-chatgpt-pluspro)
98
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)
99
99
  - [⚠️ Warning](#️-warning)
100
100
  - [Verify the setup](#verify-the-setup)
101
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-)
102
104
  - [Too Complicated?](#too-complicated)
103
105
  - [Uninstallation](#uninstallation)
104
106
  - [Features](#features)
@@ -106,9 +108,11 @@ No stupid token consumption massive subagents here. No bloat tools here.
106
108
  - [Background Agents: Work Like a Team](#background-agents-work-like-a-team)
107
109
  - [The Tools: Your Teammates Deserve Better](#the-tools-your-teammates-deserve-better)
108
110
  - [Why Are You the Only One Using an IDE?](#why-are-you-the-only-one-using-an-ide)
111
+ - [Session Management](#session-management)
109
112
  - [Context Is All You Need](#context-is-all-you-need)
110
113
  - [Be Multimodal. Save Tokens.](#be-multimodal-save-tokens)
111
114
  - [I Removed Their Blockers](#i-removed-their-blockers)
115
+ - [Skill-Embedded MCP Support](#skill-embedded-mcp-support)
112
116
  - [Goodbye Claude Code. Hello Oh My OpenCode.](#goodbye-claude-code-hello-oh-my-opencode)
113
117
  - [Hooks Integration](#hooks-integration)
114
118
  - [Config Loaders](#config-loaders)
@@ -116,16 +120,22 @@ No stupid token consumption massive subagents here. No bloat tools here.
116
120
  - [Compatibility Toggles](#compatibility-toggles)
117
121
  - [Not Just for the Agents](#not-just-for-the-agents)
118
122
  - [Configuration](#configuration)
123
+ - [JSONC Support](#jsonc-support)
119
124
  - [Google Auth](#google-auth)
120
125
  - [Agents](#agents)
121
126
  - [Permission Options](#permission-options)
127
+ - [Built-in Skills](#built-in-skills)
122
128
  - [Sisyphus Agent](#sisyphus-agent)
129
+ - [Background Tasks](#background-tasks)
130
+ - [Categories](#categories)
123
131
  - [Hooks](#hooks)
124
132
  - [MCPs](#mcps)
125
133
  - [LSP](#lsp)
126
134
  - [Experimental](#experimental)
127
135
  - [Author's Note](#authors-note)
128
136
  - [Warnings](#warnings)
137
+ - [Loved by professionals at](#loved-by-professionals-at)
138
+ - [Sponsors](#sponsors)
129
139
 
130
140
  # Oh My OpenCode
131
141
 
@@ -330,7 +340,7 @@ First, add the opencode-antigravity-auth plugin:
330
340
  {
331
341
  "plugin": [
332
342
  "oh-my-opencode",
333
- "opencode-antigravity-auth@1.2.7"
343
+ "opencode-antigravity-auth@1.2.8"
334
344
  ]
335
345
  }
336
346
  ```
@@ -544,6 +554,7 @@ Hand your best tools to your best colleagues. Now they can properly refactor, na
544
554
  - **ast_grep_search**: AST-aware code pattern search (25 languages)
545
555
  - **ast_grep_replace**: AST-aware code replacement
546
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).
547
558
 
548
559
  #### Session Management
549
560
 
@@ -689,7 +700,8 @@ Disable specific Claude Code compatibility features with the `claude_code` confi
689
700
  "commands": false,
690
701
  "skills": false,
691
702
  "agents": false,
692
- "hooks": false
703
+ "hooks": false,
704
+ "plugins": false
693
705
  }
694
706
  }
695
707
  ```
@@ -701,9 +713,25 @@ Disable specific Claude Code compatibility features with the `claude_code` confi
701
713
  | `skills` | `~/.claude/skills/*/SKILL.md`, `./.claude/skills/*/SKILL.md` | - |
702
714
  | `agents` | `~/.claude/agents/*.md`, `./.claude/agents/*.md` | Built-in agents (oracle, librarian, etc.) |
703
715
  | `hooks` | `~/.claude/settings.json`, `./.claude/settings.json`, `./.claude/settings.local.json` | - |
716
+ | `plugins` | `~/.claude/plugins/` (Claude Code marketplace plugins) | - |
704
717
 
705
718
  All toggles default to `true` (enabled). Omit the `claude_code` object for full Claude Code compatibility.
706
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
+
707
735
  ### Not Just for the Agents
708
736
 
709
737
  When agents thrive, you thrive. But I want to help you directly too.
@@ -746,10 +774,10 @@ Config file locations (priority order):
746
774
  1. `.opencode/oh-my-opencode.json` (project)
747
775
  2. User config (platform-specific):
748
776
 
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` |
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` |
753
781
 
754
782
  Schema autocomplete supported:
755
783
 
@@ -773,10 +801,10 @@ When both `oh-my-opencode.jsonc` and `oh-my-opencode.json` files exist, `.jsonc`
773
801
  ```jsonc
774
802
  {
775
803
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
776
-
804
+
777
805
  // Enable Google Gemini via Antigravity OAuth
778
806
  "google_auth": false,
779
-
807
+
780
808
  /* Agent overrides - customize models for specific tasks */
781
809
  "agents": {
782
810
  "oracle": {
@@ -889,6 +917,7 @@ Available agents: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `
889
917
  Oh My OpenCode includes built-in skills that provide additional capabilities:
890
918
 
891
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.
892
921
 
893
922
  Disable built-in skills via `disabled_skills` in `~/.config/opencode/oh-my-opencode.json` or `.opencode/oh-my-opencode.json`:
894
923
 
@@ -898,7 +927,25 @@ Disable built-in skills via `disabled_skills` in `~/.config/opencode/oh-my-openc
898
927
  }
899
928
  ```
900
929
 
901
- 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. |
902
949
 
903
950
  ### Sisyphus Agent
904
951
 
@@ -906,7 +953,8 @@ When enabled (default), Sisyphus provides a powerful orchestrator with optional
906
953
 
907
954
  - **Sisyphus**: Primary orchestrator agent (Claude Opus 4.5)
908
955
  - **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)
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
910
958
 
911
959
  **Configuration Options:**
912
960
 
@@ -955,8 +1003,11 @@ You can also customize Sisyphus agents like other agents:
955
1003
  "OpenCode-Builder": {
956
1004
  "model": "anthropic/claude-opus-4"
957
1005
  },
958
- "Planner-Sisyphus": {
1006
+ "Prometheus (Planner)": {
959
1007
  "model": "openai/gpt-5.2"
1008
+ },
1009
+ "Metis (Plan Consultant)": {
1010
+ "model": "anthropic/claude-sonnet-4-5"
960
1011
  }
961
1012
  }
962
1013
  }
@@ -966,8 +1017,86 @@ You can also customize Sisyphus agents like other agents:
966
1017
  | --------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
967
1018
  | `disabled` | `false` | When `true`, disables all Sisyphus orchestration and restores original build/plan as primary. |
968
1019
  | `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. |
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`.
971
1100
 
972
1101
  ### Hooks
973
1102
 
@@ -1039,13 +1168,13 @@ Opt-in experimental features that may change or be removed in future versions. U
1039
1168
  }
1040
1169
  ```
1041
1170
 
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. |
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. |
1049
1178
 
1050
1179
  **Warning**: These features are experimental and may cause unexpected behavior. Enable only if you understand the implications.
1051
1180
 
package/README.zh-cn.md CHANGED
@@ -47,12 +47,18 @@
47
47
 
48
48
  ## 用户评价
49
49
 
50
+ > "它让我取消了Cursor的订阅。开源社区正在发生令人难以置信的事情。" - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
51
+
50
52
  > "如果 Claude Code 能在 7 天内完成人类 3 个月的工作,那么 Sisyphus 只需要 1 小时。任务完成之前它就是一直干。It is a discipline agent." — B, Quant Researcher
51
53
 
52
54
  > "只用了一天,就用 Oh My Opencode 干掉了 8000 个 eslint 警告" — [Jacob Ferrari](https://x.com/jacobferrari_/status/2003258761952289061)
53
55
 
54
56
  > "用Ohmyopencode和ralph loop,一夜之间把45,000行的tauri应用转成了SaaS网页应用。从面试提示开始,让它对问题进行评分和推荐。看着它工作真是太神奇了,早上醒来一个基本能用的网站就搞定了!" - [James Hargis](https://x.com/hargabyte/status/2007299688261882202)
55
57
 
58
+ > "用了 oh-my-opencode,你就回不去了" — [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
59
+
60
+ > "我还没法用言语表达它到底好在哪,但开发体验已经达到了完全不同的次元。" - [苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
61
+
56
62
  > "这个周末在用open code、oh my opencode和supermemory做一个我的世界/魂类的怪物项目。"
57
63
  > "吃完午饭去散步的时候让它加蹲下动画。[视频]" - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
58
64
 
@@ -60,16 +66,8 @@
60
66
 
61
67
  > "如果你能说服 @yeon_gyu_kim,就雇佣他吧,这家伙彻底改变了 opencode" — [mysticaltech](https://x.com/mysticaltech/status/2001858758608376079)
62
68
 
63
- > "哇靠 @androolloyd 这玩意儿是真的,oh my opencode 太强了" — [z80.eth](https://x.com/0xz80/status/2001815226505924791)
64
-
65
- > "用了 oh-my-opencode,你就回不去了" — [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
66
-
67
- > "Oh My Opencode 独孤求败,没有对手" — [RyanOnThePath](https://x.com/RyanOnThePath/status/2001438321252118548)
68
-
69
69
  > "Oh My OpenCode Is Actually Insane" - [YouTube - Darren Builds AI](https://www.youtube.com/watch?v=G_Snfh2M41M)
70
70
 
71
- > "西西弗斯这个名字本身不就很美吗?" — Sigrid ([@sigridjin_eth](https://x.com/sigridjin_eth))
72
-
73
71
  ---
74
72
 
75
73
  ## 目录
@@ -308,7 +306,7 @@ opencode auth login
308
306
  {
309
307
  "plugin": [
310
308
  "oh-my-opencode",
311
- "opencode-antigravity-auth@1.2.7"
309
+ "opencode-antigravity-auth@1.2.8"
312
310
  ]
313
311
  }
314
312
  ```
@@ -647,7 +645,8 @@ Oh My OpenCode 会扫这些地方:
647
645
  "commands": false,
648
646
  "skills": false,
649
647
  "agents": false,
650
- "hooks": false
648
+ "hooks": false,
649
+ "plugins": false
651
650
  }
652
651
  }
653
652
  ```
@@ -659,9 +658,25 @@ Oh My OpenCode 会扫这些地方:
659
658
  | `skills` | `~/.claude/skills/*/SKILL.md`, `./.claude/skills/*/SKILL.md` | - |
660
659
  | `agents` | `~/.claude/agents/*.md`, `./.claude/agents/*.md` | 内置 Agent(oracle、librarian 等) |
661
660
  | `hooks` | `~/.claude/settings.json`, `./.claude/settings.json`, `./.claude/settings.local.json` | - |
661
+ | `plugins` | `~/.claude/plugins/`(Claude Code 市场插件) | - |
662
662
 
663
663
  默认都是 `true`(开)。想全兼容 Claude Code?那就别写 `claude_code` 这段。
664
664
 
665
+ **只禁用特定插件**用 `plugins_override`:
666
+
667
+ ```json
668
+ {
669
+ "claude_code": {
670
+ "plugins_override": {
671
+ "claude-mem@thedotmack": false,
672
+ "some-other-plugin@marketplace": false
673
+ }
674
+ }
675
+ }
676
+ ```
677
+
678
+ 这样插件系统还是开着的,只是用完整标识符(`plugin-name@marketplace-name`)关掉特定插件。
679
+
665
680
  ### 不只是为了 Agent,也是为了你
666
681
 
667
682
  Agent 爽了,你自然也爽。但我还想直接让你爽。
@@ -848,7 +863,8 @@ Agent 爽了,你自然也爽。但我还想直接让你爽。
848
863
 
849
864
  - **Sisyphus**:主编排 Agent(Claude Opus 4.5)
850
865
  - **OpenCode-Builder**:OpenCode 默认构建 Agent(因 SDK 限制仅改名,默认禁用)
851
- - **Planner-Sisyphus**:OpenCode 默认计划 Agent(因 SDK 限制仅改名,默认启用)
866
+ - **Prometheus (Planner)**:OpenCode 默认计划 Agent + work-planner 方法论(默认启用)
867
+ - **Metis (Plan Consultant)**:识别隐藏需求和 AI 失败点的预规划分析 Agent
852
868
 
853
869
  **配置选项:**
854
870
 
@@ -897,8 +913,11 @@ Sisyphus Agent 也能自定义:
897
913
  "OpenCode-Builder": {
898
914
  "model": "anthropic/claude-opus-4"
899
915
  },
900
- "Planner-Sisyphus": {
916
+ "Prometheus (Planner)": {
901
917
  "model": "openai/gpt-5.2"
918
+ },
919
+ "Metis (Plan Consultant)": {
920
+ "model": "anthropic/claude-sonnet-4-5"
902
921
  }
903
922
  }
904
923
  }
@@ -908,8 +927,42 @@ Sisyphus Agent 也能自定义:
908
927
  | --------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
909
928
  | `disabled` | `false` | 设为 `true` 就禁用所有 Sisyphus 编排,恢复原来的 build/plan。 |
910
929
  | `default_builder_enabled` | `false` | 设为 `true` 就启用 OpenCode-Builder Agent(与 OpenCode build 相同,因 SDK 限制仅改名)。默认禁用。 |
911
- | `planner_enabled` | `true` | 设为 `true` 就启用 Planner-Sisyphus Agent(与 OpenCode plan 相同,因 SDK 限制仅改名)。默认启用。 |
912
- | `replace_plan` | `true` | 设为 `true` 就把默认计划 Agent 降级为子 Agent 模式。设为 `false` 可以同时保留 Planner-Sisyphus 和默认计划。 |
930
+ | `planner_enabled` | `true` | 设为 `true` 就启用 Prometheus (Planner) Agent(含 work-planner 方法论)。默认启用。 |
931
+ | `replace_plan` | `true` | 设为 `true` 就把默认计划 Agent 降级为子 Agent 模式。设为 `false` 可以同时保留 Prometheus (Planner) 和默认计划。 |
932
+
933
+ ### Background Tasks(后台任务)
934
+
935
+ 配置后台 Agent 任务的并发限制。这控制了可以同时运行多少个并行后台 Agent。
936
+
937
+ ```json
938
+ {
939
+ "background_task": {
940
+ "defaultConcurrency": 5,
941
+ "providerConcurrency": {
942
+ "anthropic": 3,
943
+ "openai": 5,
944
+ "google": 10
945
+ },
946
+ "modelConcurrency": {
947
+ "anthropic/claude-opus-4-5": 2,
948
+ "google/gemini-3-flash": 10
949
+ }
950
+ }
951
+ }
952
+ ```
953
+
954
+ | 选项 | 默认值 | 说明 |
955
+ | --------------------- | ------ | -------------------------------------------------------------------------------------------------------------- |
956
+ | `defaultConcurrency` | - | 所有提供商/模型的默认最大并发后台任务数 |
957
+ | `providerConcurrency` | - | 按提供商设置并发限制。键是提供商名称(例如:`anthropic`、`openai`、`google`) |
958
+ | `modelConcurrency` | - | 按模型设置并发限制。键是完整的模型名称(例如:`anthropic/claude-opus-4-5`)。会覆盖提供商级别的限制。 |
959
+
960
+ **优先级顺序**: `modelConcurrency` > `providerConcurrency` > `defaultConcurrency`
961
+
962
+ **使用场景**:
963
+ - 限制昂贵的模型(如 Opus)以防止成本飙升
964
+ - 允许快速/便宜的模型(如 Gemini Flash)执行更多并发任务
965
+ - 通过设置提供商级别上限来遵守提供商的速率限制
913
966
 
914
967
  ### Hooks
915
968