Skip to content

Commit a74d0f1

Browse files
justsisyphusjustsisyphus
committed
feat(agents): add hephaestus agent - autonomous deep worker with GPT 5.2 Codex
Adds Hephaestus, an autonomous deep worker agent inspired by AmpCode's deep mode. Uses GPT 5.2 Codex with medium reasoning effort for goal-oriented execution. - Implements requiresModel gating: only activates when gpt-5.2-codex available - Adds model fallback chain: gpt-5.2-codex → claude-opus-4-5 → gemini-3-pro - Orders core agents: sisyphus → hephaestus → prometheus → atlas - Updates schema, tests, and snapshots accordingly 🤖 Generated with [OhMyOpenCode](https://github.com/code-yeongyu/oh-my-opencode) assistance
1 parent d4acd23 commit a74d0f1

File tree

20 files changed

+1104
-23
lines changed

20 files changed

+1104
-23
lines changed

‎.github/assets/hephaestus.png‎

8.21 MB
Loading

‎AGENTS.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,14 +18,14 @@
1818

1919
## OVERVIEW
2020

21-
OpenCode plugin: multi-model agent orchestration (Claude Opus 4.5, GPT-5.2, Gemini 3 Flash, Grok Code). 32 lifecycle hooks, 20+ tools (LSP, AST-Grep, delegation), 10 specialized agents, full Claude Code compatibility. "oh-my-zsh" for OpenCode.
21+
OpenCode plugin: multi-model agent orchestration (Claude Opus 4.5, GPT-5.2, Gemini 3 Flash, Grok Code). 32 lifecycle hooks, 20+ tools (LSP, AST-Grep, delegation), 11 specialized agents, full Claude Code compatibility. "oh-my-zsh" for OpenCode.
2222

2323
## STRUCTURE
2424

2525
```
2626
oh-my-opencode/
2727
├── src/
28-
│ ├── agents/ # 10 AI agents - see src/agents/AGENTS.md
28+
│ ├── agents/ # 11 AI agents - see src/agents/AGENTS.md
2929
│ ├── hooks/ # 32 lifecycle hooks - see src/hooks/AGENTS.md
3030
│ ├── tools/ # 20+ tools - see src/tools/AGENTS.md
3131
│ ├── features/ # Background agents, Claude Code compat - see src/features/AGENTS.md
@@ -99,6 +99,7 @@ oh-my-opencode/
9999
| Agent | Model | Purpose |
100100
|-------|-------|---------|
101101
| Sisyphus | anthropic/claude-opus-4-5 | Primary orchestrator (fallback: kimi-k2.5 → glm-4.7 → gpt-5.2-codex → gemini-3-pro) |
102+
| Hephaestus | openai/gpt-5.2-codex | Autonomous deep worker, "The Legitimate Craftsman" |
102103
| Atlas | anthropic/claude-sonnet-4-5 | Master orchestrator (fallback: kimi-k2.5 → gpt-5.2) |
103104
| oracle | openai/gpt-5.2 | Consultation, debugging |
104105
| librarian | zai-coding-plan/glm-4.7 | Docs, GitHub search (fallback: glm-4.7-free) |

‎README.ja.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,7 @@
113113
- [エージェントの時代ですから](#エージェントの時代ですから)
114114
- [🪄 魔法の言葉：`ultrawork`](#-魔法の言葉ultrawork)
115115
- [読みたい方のために：シジフォスに会う](#読みたい方のためにシジフォスに会う)
116+
- [自律性を求めるなら: ヘパイストスに会おう](#自律性を求めるなら-ヘパイストスに会おう)
116117
- [インストールするだけで。](#インストールするだけで)
117118
- [インストール](#インストール)
118119
- [人間の方へ](#人間の方へ)
@@ -186,6 +187,7 @@ Windows から Linux に初めて乗り換えた時のこと、自分の思い
186187
*以下の内容はすべてカスタマイズ可能です。必要なものだけを使ってください。デフォルトではすべての機能が有効になっています。何もしなくても大丈夫です。*
187188

188189
- シジフォスのチームメイト (Curated Agents)
190+
- Hephaestus: 自律型ディープワーカー、目標指向実行 (GPT 5.2 Codex Medium) — *正当な職人*
189191
- Oracle: 設計、デバッグ (GPT 5.2 Medium)
190192
- Frontend UI/UX Engineer: フロントエンド開発 (Gemini 3 Pro)
191193
- Librarian: 公式ドキュメント、オープンソース実装、コードベース探索 (Claude Sonnet 4.5)
@@ -202,6 +204,24 @@ Windows から Linux に初めて乗り換えた時のこと、自分の思い
202204
- Async Agents
203205
- ...
204206

207+
### 自律性を求めるなら: ヘパイストスに会おう
208+
209+
![Meet Hephaestus](.github/assets/hephaestus.png)
210+
211+
ギリシャ神話において、ヘパイストスは鍛冶、火、金属加工、職人技の神でした—比類のない精密さと献身で神々の武器を作り上げた神聖な鍛冶師です。
212+
**自律型ディープワーカーを紹介します: ヘパイストス (GPT 5.2 Codex Medium)。正当な職人エージェント。**
213+
214+
*なぜ「正当な」なのか？Anthropicがサードパーティアクセスを利用規約違反を理由にブロックした時、コミュニティで「正当な」使用についてのジョークが始まりました。ヘパイストスはこの皮肉を受け入れています—彼は近道をせず、正しい方法で、体系的かつ徹底的に物を作る職人です。*
215+
216+
ヘパイストスは[AmpCodeのディープモード](https://ampcode.com)にインスパイアされました—決定的な行動の前に徹底的な調査を行う自律的問題解決。ステップバイステップの指示は必要ありません；目標を与えれば、残りは自分で考えます。
217+
218+
**主な特徴:**
219+
- **目標指向**: レシピではなく目標を与えてください。ステップは自分で決めます。
220+
- **行動前の探索**: コードを1行書く前に、2-5個のexplore/librarianエージェントを並列で起動します。
221+
- **エンドツーエンドの完了**: 検証の証拠とともに100%完了するまで止まりません。
222+
- **パターンマッチング**: 既存のコードベースを検索してプロジェクトのスタイルに合わせます—AIスロップなし。
223+
- **正当な精密さ**: マスター鍛冶師のようにコードを作ります—外科的に、最小限に、必要なものだけを正確に。
224+
205225
#### インストールするだけで。
206226

207227
[overview page](docs/guide/overview.md) を読めば多くのことが学べますが、以下はワークフローの例です。

‎README.ko.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -116,6 +116,7 @@
116116
- [🪄 마법의 단어: `ultrawork`](#-마법의-단어-ultrawork)
117117
- [읽고 싶은 분들을 위해: Sisyphus를 소개합니다](#읽고-싶은-분들을-위해-sisyphus를-소개합니다)
118118
- [그냥 설치하세요](#그냥-설치하세요)
119+
- [자율성을 원한다면: 헤파이스토스를 만나세요](#자율성을-원한다면-헤파이스토스를-만나세요)
119120
- [설치](#설치)
120121
- [인간을 위한](#인간을-위한)
121122
- [LLM 에이전트를 위한](#llm-에이전트를-위한)
@@ -194,6 +195,7 @@ Hey please read this readme and tell me why it is different from other agent har
194195
*아래의 모든 것은 사용자 정의 가능합니다. 원하는 것을 가져가세요. 모든 기능은 기본적으로 활성화됩니다. 아무것도 할 필요가 없습니다. 포함되어 있으며, 즉시 작동합니다.*
195196

196197
- Sisyphus의 팀원 (큐레이팅된 에이전트)
198+
- Hephaestus: 자율적 딥 워커, 목표 지향 실행 (GPT 5.2 Codex Medium) — *합법적인 장인*
197199
- Oracle: 디자인, 디버깅 (GPT 5.2 Medium)
198200
- Frontend UI/UX Engineer: 프론트엔드 개발 (Gemini 3 Pro)
199201
- Librarian: 공식 문서, 오픈 소스 구현, 코드베이스 탐색 (Claude Sonnet 4.5)
@@ -235,6 +237,24 @@ Hey please read this readme and tell me why it is different from other agent har
235237

236238
이 모든 것이 필요하지 않다면, 앞서 언급했듯이 특정 기능을 선택할 수 있습니다.
237239

240+
### 자율성을 원한다면: 헤파이스토스를 만나세요
241+
242+
![Meet Hephaestus](.github/assets/hephaestus.png)
243+
244+
그리스 신화에서 헤파이스토스는 대장간, 불, 금속 세공, 장인 정신의 신이었습니다—비교할 수 없는 정밀함과 헌신으로 신들의 무기를 만든 신성한 대장장이입니다.
245+
**자율적 딥 워커를 소개합니다: 헤파이스토스 (GPT 5.2 Codex Medium). 합법적인 장인 에이전트.**
246+
247+
*왜 "합법적인"일까요? Anthropic이 ToS 위반을 이유로 서드파티 접근을 차단했을 때, 커뮤니티에서 "합법적인" 사용에 대한 농담이 시작되었습니다. 헤파이스토스는 이 아이러니를 받아들입니다—그는 편법 없이 올바른 방식으로, 체계적이고 철저하게 만드는 장인입니다.*
248+
249+
헤파이스토스는 [AmpCode의 딥 모드](https://ampcode.com)에서 영감을 받았습니다—결정적인 행동 전에 철저한 조사를 하는 자율적 문제 해결. 단계별 지시가 필요 없습니다; 목표만 주면 나머지는 알아서 합니다.
250+
251+
**핵심 특성:**
252+
- **목표 지향**: 레시피가 아닌 목표를 주세요. 단계는 스스로 결정합니다.
253+
- **행동 전 탐색**: 코드 한 줄 쓰기 전에 2-5개의 explore/librarian 에이전트를 병렬로 실행합니다.
254+
- **끝까지 완료**: 검증 증거와 함께 100% 완료될 때까지 멈추지 않습니다.
255+
- **패턴 매칭**: 기존 코드베이스를 검색하여 프로젝트 스타일에 맞춥니다—AI 슬롭 없음.
256+
- **합법적인 정밀함**: 마스터 대장장이처럼 코드를 만듭니다—수술적으로, 최소한으로, 정확히 필요한 것만.
257+
238258
## 설치
239259

240260
### 인간을 위한

‎README.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -114,6 +114,7 @@ Yes, technically possible. But I cannot recommend using it.
114114
- [It's the Age of Agents](#its-the-age-of-agents)
115115
- [🪄 The Magic Word: `ultrawork`](#-the-magic-word-ultrawork)
116116
- [For Those Who Want to Read: Meet Sisyphus](#for-those-who-want-to-read-meet-sisyphus)
117+
- [For Those Who Want Autonomy: Meet Hephaestus](#for-those-who-want-autonomy-meet-hephaestus)
117118
- [Just Install It.](#just-install-it)
118119
- [Installation](#installation)
119120
- [For Humans](#for-humans)
@@ -193,6 +194,7 @@ Meet our main agent: Sisyphus (Opus 4.5 High). Below are the tools Sisyphus uses
193194
*Everything below is customizable. Take what you want. All features are enabled by default. You don't have to do anything. Battery Included, works out of the box.*
194195

195196
- Sisyphus's Teammates (Curated Agents)
197+
- Hephaestus: Autonomous deep worker, goal-oriented execution (GPT 5.2 Codex Medium) — *The Legitimate Craftsman*
196198
- Oracle: Design, debugging (GPT 5.2 Medium)
197199
- Frontend UI/UX Engineer: Frontend development (Gemini 3 Pro)
198200
- Librarian: Official docs, open source implementations, codebase exploration (Claude Sonnet 4.5)
@@ -209,6 +211,24 @@ Meet our main agent: Sisyphus (Opus 4.5 High). Below are the tools Sisyphus uses
209211
- Async Agents
210212
- ...
211213

214+
### For Those Who Want Autonomy: Meet Hephaestus
215+
216+
![Meet Hephaestus](.github/assets/hephaestus.png)
217+
218+
In Greek mythology, Hephaestus was the god of forge, fire, metalworking, and craftsmanship—the divine blacksmith who crafted weapons for the gods with unmatched precision and dedication.
219+
**Meet our autonomous deep worker: Hephaestus (GPT 5.2 Codex Medium). The Legitimate Craftsman Agent.**
220+
221+
*Why "Legitimate"? When Anthropic blocked third-party access citing ToS violations, the community started joking about "legitimate" usage. Hephaestus embraces this irony—he's the craftsman who builds things the right way, methodically and thoroughly, without cutting corners.*
222+
223+
Hephaestus is inspired by [AmpCode's deep mode](https://ampcode.com)—autonomous problem-solving with thorough research before decisive action. He doesn't need step-by-step instructions; give him a goal and he'll figure out the rest.
224+
225+
**Key Characteristics:**
226+
- **Goal-Oriented**: Give him an objective, not a recipe. He determines the steps himself.
227+
- **Explores Before Acting**: Fires 2-5 parallel explore/librarian agents before writing a single line of code.
228+
- **End-to-End Completion**: Doesn't stop until the task is 100% done with evidence of verification.
229+
- **Pattern Matching**: Searches existing codebase to match your project's style—no AI slop.
230+
- **Legitimate Precision**: Crafts code like a master blacksmith—surgical, minimal, exactly what's needed.
231+
212232
#### Just Install This
213233

214234
You can learn a lot from [overview page](docs/guide/overview.md), but following is like the example workflow.

‎README.zh-cn.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -114,6 +114,7 @@
114114
- [这是智能体时代](#这是智能体时代)
115115
- [🪄 魔法词：`ultrawork`](#-魔法词ultrawork)
116116
- [给想阅读的人：认识 Sisyphus](#给想阅读的人认识-sisyphus)
117+
- [追求自主性：认识赫菲斯托斯](#追求自主性认识赫菲斯托斯)
117118
- [直接安装就行。](#直接安装就行)
118119
- [安装](#安装)
119120
- [面向人类用户](#面向人类用户)
@@ -190,6 +191,7 @@
190191
*以下所有内容都是可配置的。按需选取。所有功能默认启用。你不需要做任何事情。开箱即用，电池已包含。*
191192

192193
- Sisyphus 的队友（精选智能体）
194+
- Hephaestus：自主深度工作者，目标导向执行（GPT 5.2 Codex Medium）— *合法的工匠*
193195
- Oracle：设计、调试 (GPT 5.2 Medium)
194196
- Frontend UI/UX Engineer：前端开发 (Gemini 3 Pro)
195197
- Librarian：官方文档、开源实现、代码库探索 (Claude Sonnet 4.5)
@@ -206,6 +208,24 @@
206208
- 异步智能体
207209
- ...
208210

211+
### 追求自主性：认识赫菲斯托斯
212+
213+
![Meet Hephaestus](.github/assets/hephaestus.png)
214+
215+
在希腊神话中，赫菲斯托斯是锻造、火焰、金属加工和工艺之神——他是神圣的铁匠，以无与伦比的精准和奉献为众神打造武器。
216+
**介绍我们的自主深度工作者：赫菲斯托斯（GPT 5.2 Codex Medium）。合法的工匠代理。**
217+
218+
*为什么是"合法的"？当Anthropic以违反服务条款为由封锁第三方访问时，社区开始调侃"合法"使用。赫菲斯托斯拥抱这种讽刺——他是那种用正确的方式、有条不紊、彻底地构建事物的工匠，绝不走捷径。*
219+
220+
赫菲斯托斯的灵感来自[AmpCode的深度模式](https://ampcode.com)——在采取决定性行动之前进行彻底研究的自主问题解决。他不需要逐步指示；给他一个目标，他会自己找出方法。
221+
222+
**核心特性：**
223+
- **目标导向**：给他目标，而不是配方。他自己决定步骤。
224+
- **行动前探索**：在写一行代码之前，并行启动2-5个explore/librarian代理。
225+
- **端到端完成**：在有验证证据证明100%完成之前不会停止。
226+
- **模式匹配**：搜索现有代码库以匹配您项目的风格——没有AI垃圾。
227+
- **合法的精准**：像大师铁匠一样编写代码——精准、最小化、只做需要的。
228+
209229
#### 直接安装就行。
210230

211231
你可以从 [overview page](docs/guide/overview.md) 学到很多，但以下是示例工作流程。

‎assets/oh-my-opencode.schema.json‎

Lines changed: 172 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@
2121
"type": "string",
2222
"enum": [
2323
"sisyphus",
24+
"hephaestus",
2425
"prometheus",
2526
"oracle",
2627
"librarian",
@@ -610,6 +611,177 @@
610611
}
611612
}
612613
},
614+
"hephaestus": {
615+
"type": "object",
616+
"properties": {
617+
"model": {
618+
"type": "string"
619+
},
620+
"variant": {
621+
"type": "string"
622+
},
623+
"category": {
624+
"type": "string"
625+
},
626+
"skills": {
627+
"type": "array",
628+
"items": {
629+
"type": "string"
630+
}
631+
},
632+
"temperature": {
633+
"type": "number",
634+
"minimum": 0,
635+
"maximum": 2
636+
},
637+
"top_p": {
638+
"type": "number",
639+
"minimum": 0,
640+
"maximum": 1
641+
},
642+
"prompt": {
643+
"type": "string"
644+
},
645+
"prompt_append": {
646+
"type": "string"
647+
},
648+
"tools": {
649+
"type": "object",
650+
"propertyNames": {
651+
"type": "string"
652+
},
653+
"additionalProperties": {
654+
"type": "boolean"
655+
}
656+
},
657+
"disable": {
658+
"type": "boolean"
659+
},
660+
"description": {
661+
"type": "string"
662+
},
663+
"mode": {
664+
"type": "string",
665+
"enum": [
666+
"subagent",
667+
"primary",
668+
"all"
669+
]
670+
},
671+
"color": {
672+
"type": "string",
673+
"pattern": "^#[0-9A-Fa-f]{6}$"
674+
},
675+
"permission": {
676+
"type": "object",
677+
"properties": {
678+
"edit": {
679+
"type": "string",
680+
"enum": [
681+
"ask",
682+
"allow",
683+
"deny"
684+
]
685+
},
686+
"bash": {
687+
"anyOf": [
688+
{
689+
"type": "string",
690+
"enum": [
691+
"ask",
692+
"allow",
693+
"deny"
694+
]
695+
},
696+
{
697+
"type": "object",
698+
"propertyNames": {
699+
"type": "string"
700+
},
701+
"additionalProperties": {
702+
"type": "string",
703+
"enum": [
704+
"ask",
705+
"allow",
706+
"deny"
707+
]
708+
}
709+
}
710+
]
711+
},
712+
"webfetch": {
713+
"type": "string",
714+
"enum": [
715+
"ask",
716+
"allow",
717+
"deny"
718+
]
719+
},
720+
"doom_loop": {
721+
"type": "string",
722+
"enum": [
723+
"ask",
724+
"allow",
725+
"deny"
726+
]
727+
},
728+
"external_directory": {
729+
"type": "string",
730+
"enum": [
731+
"ask",
732+
"allow",
733+
"deny"
734+
]
735+
}
736+
}
737+
},
738+
"maxTokens": {
739+
"type": "number"
740+
},
741+
"thinking": {
742+
"type": "object",
743+
"properties": {
744+
"type": {
745+
"type": "string",
746+
"enum": [
747+
"enabled",
748+
"disabled"
749+
]
750+
},
751+
"budgetTokens": {
752+
"type": "number"
753+
}
754+
},
755+
"required": [
756+
"type"
757+
]
758+
},
759+
"reasoningEffort": {
760+
"type": "string",
761+
"enum": [
762+
"low",
763+
"medium",
764+
"high",
765+
"xhigh"
766+
]
767+
},
768+
"textVerbosity": {
769+
"type": "string",
770+
"enum": [
771+
"low",
772+
"medium",
773+
"high"
774+
]
775+
},
776+
"providerOptions": {
777+
"type": "object",
778+
"propertyNames": {
779+
"type": "string"
780+
},
781+
"additionalProperties": {}
782+
}
783+
}
784+
},
613785
"sisyphus-junior": {
614786
"type": "object",
615787
"properties": {

‎docs/features.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,14 @@
44

55
## Agents: Your AI Team
66

7-
Oh-My-OpenCode provides 10 specialized AI agents. Each has distinct expertise, optimized models, and tool permissions.
7+
Oh-My-OpenCode provides 11 specialized AI agents. Each has distinct expertise, optimized models, and tool permissions.
88

99
### Core Agents
1010

1111
| Agent | Model | Purpose |
1212
|-------|-------|---------|
1313
| **Sisyphus** | `anthropic/claude-opus-4-5` | **The default orchestrator.** Plans, delegates, and executes complex tasks using specialized subagents with aggressive parallel execution. Todo-driven workflow with extended thinking (32k budget). Fallback: kimi-k2.5 → glm-4.7 → gpt-5.2-codex → gemini-3-pro. |
14+
| **Hephaestus** | `openai/gpt-5.2-codex` | **The Legitimate Craftsman.** Autonomous deep worker inspired by AmpCode's deep mode. Goal-oriented execution with thorough research before action. Explores codebase patterns, completes tasks end-to-end without premature stopping. Named after the Greek god of forge and craftsmanship. Requires gpt-5.2-codex. Fallback: claude-opus-4-5 → gemini-3-pro. |
1415
| **oracle** | `openai/gpt-5.2` | Architecture decisions, code review, debugging. Read-only consultation - stellar logical reasoning and deep analysis. Inspired by AmpCode. |
1516
| **librarian** | `zai-coding-plan/glm-4.7` | Multi-repo analysis, documentation lookup, OSS implementation examples. Deep codebase understanding with evidence-based answers. Fallback: glm-4.7-free → claude-sonnet-4-5. |
1617
| **explore** | `anthropic/claude-haiku-4-5` | Fast codebase exploration and contextual grep. Fallback: gpt-5-mini → gpt-5-nano. |

0 commit comments

Comments
 (0)