oh-my-opencode 3.7.4 → 3.8.0

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 (127) hide show
  1. package/README.ja.md +206 -243
  2. package/README.ko.md +205 -244
  3. package/README.md +176 -174
  4. package/README.zh-cn.md +211 -255
  5. package/dist/agents/atlas/default.d.ts +1 -1
  6. package/dist/agents/atlas/gpt.d.ts +1 -1
  7. package/dist/agents/atlas/prompt-section-builder.d.ts +1 -1
  8. package/dist/agents/builtin-agents/environment-context.d.ts +5 -1
  9. package/dist/agents/builtin-agents/general-agents.d.ts +1 -0
  10. package/dist/agents/builtin-agents/hephaestus-agent.d.ts +1 -0
  11. package/dist/agents/builtin-agents/sisyphus-agent.d.ts +1 -0
  12. package/dist/agents/builtin-agents.d.ts +1 -1
  13. package/dist/agents/dynamic-agent-prompt-builder.d.ts +0 -5
  14. package/dist/agents/index.d.ts +2 -1
  15. package/dist/agents/prometheus/gpt.d.ts +24 -0
  16. package/dist/agents/prometheus/index.d.ts +3 -1
  17. package/dist/agents/prometheus/system-prompt.d.ts +12 -1
  18. package/dist/agents/types.d.ts +1 -0
  19. package/dist/cli/fallback-chain-resolution.d.ts +1 -1
  20. package/dist/cli/index.js +366 -118
  21. package/dist/cli/model-fallback-requirements.d.ts +3 -0
  22. package/dist/cli/model-fallback-types.d.ts +0 -5
  23. package/dist/cli/provider-model-id-transform.d.ts +1 -1
  24. package/dist/cli/run/timestamp-output.d.ts +5 -0
  25. package/dist/cli/run/types.d.ts +1 -0
  26. package/dist/config/index.d.ts +2 -2
  27. package/dist/config/schema/agent-overrides.d.ts +75 -60
  28. package/dist/config/schema/categories.d.ts +2 -0
  29. package/dist/config/schema/experimental.d.ts +2 -0
  30. package/dist/config/schema/fallback-models.d.ts +3 -0
  31. package/dist/config/schema/hooks.d.ts +3 -3
  32. package/dist/config/schema/oh-my-opencode-config.d.ts +87 -104
  33. package/dist/config/schema/ralph-loop.d.ts +4 -0
  34. package/dist/config/schema/runtime-fallback.d.ts +10 -0
  35. package/dist/config/schema.d.ts +2 -0
  36. package/dist/create-hooks.d.ts +7 -5
  37. package/dist/features/background-agent/manager.d.ts +3 -0
  38. package/dist/features/background-agent/types.d.ts +7 -0
  39. package/dist/features/builtin-commands/templates/ralph-loop.d.ts +1 -1
  40. package/dist/features/claude-code-session-state/state.d.ts +1 -0
  41. package/dist/features/task-toast-manager/manager.d.ts +5 -0
  42. package/dist/features/task-toast-manager/types.d.ts +2 -1
  43. package/dist/features/tmux-subagent/action-executor.d.ts +10 -3
  44. package/dist/features/tmux-subagent/grid-planning.d.ts +5 -3
  45. package/dist/features/tmux-subagent/manager.d.ts +12 -0
  46. package/dist/features/tmux-subagent/pane-split-availability.d.ts +0 -1
  47. package/dist/features/tmux-subagent/spawn-target-finder.d.ts +2 -2
  48. package/dist/features/tmux-subagent/tmux-grid-constants.d.ts +4 -0
  49. package/dist/features/tmux-subagent/types.d.ts +2 -0
  50. package/dist/hooks/hashline-edit-diff-enhancer/hook.d.ts +28 -0
  51. package/dist/hooks/hashline-edit-diff-enhancer/index.d.ts +1 -0
  52. package/dist/hooks/index.d.ts +4 -2
  53. package/dist/hooks/model-fallback/hook.d.ts +60 -0
  54. package/dist/hooks/no-hephaestus-non-gpt/hook.d.ts +16 -0
  55. package/dist/hooks/no-hephaestus-non-gpt/index.d.ts +1 -0
  56. package/dist/hooks/ralph-loop/command-arguments.d.ts +8 -0
  57. package/dist/hooks/ralph-loop/continuation-prompt-injector.d.ts +1 -0
  58. package/dist/hooks/ralph-loop/iteration-continuation.d.ts +12 -0
  59. package/dist/hooks/ralph-loop/loop-state-controller.d.ts +2 -0
  60. package/dist/hooks/ralph-loop/ralph-loop-event-handler.d.ts +1 -0
  61. package/dist/hooks/ralph-loop/ralph-loop-hook.d.ts +1 -0
  62. package/dist/hooks/ralph-loop/session-reset-strategy.d.ts +3 -0
  63. package/dist/hooks/ralph-loop/types.d.ts +1 -0
  64. package/dist/hooks/runtime-fallback/agent-resolver.d.ts +5 -0
  65. package/dist/hooks/runtime-fallback/auto-retry.d.ts +10 -0
  66. package/dist/hooks/runtime-fallback/chat-message-handler.d.ts +20 -0
  67. package/dist/hooks/runtime-fallback/constants.d.ts +19 -0
  68. package/dist/hooks/runtime-fallback/error-classifier.d.ts +17 -0
  69. package/dist/hooks/runtime-fallback/event-handler.d.ts +8 -0
  70. package/dist/hooks/runtime-fallback/fallback-models.d.ts +2 -0
  71. package/dist/hooks/runtime-fallback/fallback-state.d.ts +6 -0
  72. package/dist/hooks/runtime-fallback/hook.d.ts +3 -0
  73. package/dist/hooks/runtime-fallback/index.d.ts +2 -0
  74. package/dist/hooks/runtime-fallback/message-update-handler.d.ts +5 -0
  75. package/dist/hooks/runtime-fallback/types.d.ts +59 -0
  76. package/dist/hooks/session-recovery/detect-error-type.d.ts +2 -1
  77. package/dist/hooks/session-recovery/recover-unavailable-tool.d.ts +5 -0
  78. package/dist/hooks/todo-continuation-enforcer/continuation-injection.d.ts +1 -0
  79. package/dist/hooks/todo-continuation-enforcer/countdown.d.ts +1 -0
  80. package/dist/hooks/write-existing-file-guard/hook.d.ts +1 -0
  81. package/dist/index.js +6179 -2820
  82. package/dist/oh-my-opencode.schema.json +3681 -0
  83. package/dist/plugin/chat-headers.d.ts +4 -0
  84. package/dist/plugin/chat-message.d.ts +9 -8
  85. package/dist/plugin/chat-params.d.ts +2 -3
  86. package/dist/plugin/event.d.ts +2 -6
  87. package/dist/plugin/hooks/create-core-hooks.d.ts +7 -5
  88. package/dist/plugin/hooks/create-session-hooks.d.ts +6 -6
  89. package/dist/plugin/hooks/create-tool-guard-hooks.d.ts +2 -1
  90. package/dist/plugin/hooks/create-transform-hooks.d.ts +1 -1
  91. package/dist/plugin/system-transform.d.ts +5 -0
  92. package/dist/plugin/types.d.ts +7 -1
  93. package/dist/plugin/ultrawork-db-model-override.d.ts +11 -0
  94. package/dist/plugin/ultrawork-model-override.d.ts +37 -0
  95. package/dist/shared/index.d.ts +3 -0
  96. package/dist/shared/internal-initiator-marker.d.ts +5 -0
  97. package/dist/shared/model-error-classifier.d.ts +31 -0
  98. package/dist/shared/model-resolution-pipeline.d.ts +1 -0
  99. package/dist/shared/model-resolver.d.ts +6 -0
  100. package/dist/shared/provider-model-id-transform.d.ts +1 -0
  101. package/dist/shared/session-category-registry.d.ts +32 -0
  102. package/dist/shared/session-model-state.d.ts +7 -0
  103. package/dist/shared/tmux/tmux-utils/layout.d.ts +17 -2
  104. package/dist/tools/delegate-task/background-task.d.ts +2 -1
  105. package/dist/tools/delegate-task/category-resolver.d.ts +2 -0
  106. package/dist/tools/delegate-task/skill-resolver.d.ts +1 -0
  107. package/dist/tools/delegate-task/subagent-resolver.d.ts +2 -0
  108. package/dist/tools/delegate-task/sync-task.d.ts +1 -1
  109. package/dist/tools/hashline-edit/constants.d.ts +5 -2
  110. package/dist/tools/hashline-edit/diff-utils.d.ts +6 -0
  111. package/dist/tools/hashline-edit/edit-operations.d.ts +4 -4
  112. package/dist/tools/hashline-edit/hash-computation.d.ts +1 -1
  113. package/dist/tools/hashline-edit/index.d.ts +1 -1
  114. package/dist/tools/hashline-edit/types.d.ts +4 -4
  115. package/dist/tools/hashline-edit/validation.d.ts +1 -0
  116. package/dist/tools/index.d.ts +2 -2
  117. package/dist/tools/skill/constants.d.ts +2 -2
  118. package/dist/tools/skill/types.d.ts +4 -0
  119. package/dist/tools/slashcommand/index.d.ts +1 -1
  120. package/dist/tools/slashcommand/types.d.ts +1 -7
  121. package/package.json +10 -10
  122. package/dist/hooks/ultrawork-model-override/hook.d.ts +0 -6
  123. package/dist/hooks/ultrawork-model-override/index.d.ts +0 -1
  124. package/dist/tools/slashcommand/skill-command-converter.d.ts +0 -3
  125. package/dist/tools/slashcommand/slashcommand-description.d.ts +0 -3
  126. package/dist/tools/slashcommand/slashcommand-tool.d.ts +0 -4
  127. package/dist/tools/slashcommand/tools.d.ts +0 -2
package/README.ko.md CHANGED
@@ -1,30 +1,26 @@
1
1
  > [!WARNING]
2
- > **보안 경고: 사칭 사이트**
2
+ > **보안 경고: 사칭 사이트 주의**
3
3
  >
4
- > **ohmyopencode.com은 이 프로젝트와 제휴 관계가 아닙니다.** 우리는 해당 사이트를 운영하거나 지지하지 않습니다.
4
+ > **ohmyopencode.com은 이 프로젝트와 아무런 관련이 없습니다.** 우리는 해당 사이트를 운영하거나 보증하지 않습니다.
5
5
  >
6
- > OhMyOpenCode는 **무료 오픈 소스**입니다. "공식"을 표방하는 제3자 사이트에서 설치 프로그램을 다운로드하거나 결제 정보를 입력하지 마십시오.
6
+ > OhMyOpenCode는 **무료 오픈소스**입니다. "공식"을 사칭하는 제3자 사이트에서 인스톨러를 다운로드하거나 결제 정보를 입력하지 **마세요.**
7
7
  >
8
- > 사칭 사이트는 유료 뒤에 있어 **배포하는 내용을 확인할 수 없습니다.** 해당 사이트의 다운로드는 **잠재적으로 위험한 것으로 간주**하세요.
8
+ > 사칭 사이트는 페이월 뒤에 숨어 있어 **어떤 악성 코드를 배포하는지 확인할 수 없습니다**. 해당 사이트의 다운로드는 모두 **잠재적 위험**으로 간주하세요.
9
9
  >
10
10
  > ✅ 공식 다운로드: https://github.com/code-yeongyu/oh-my-opencode/releases
11
11
 
12
12
  > [!NOTE]
13
13
  >
14
- > [![Sisyphus Labs Sisyphus is the agent that codes like your team.](./.github/assets/sisyphuslabs.png?v=2)](https://sisyphuslabs.ai)
15
- > > **Sisyphus의 완전한 제품화 버전을 구축하여 프론티어 에이전트의 미래를 정의하고 있습니다. <br />[여기서](https://sisyphuslabs.ai) 대기 명단에 등록하세요.**
16
- >
14
+ > [![Sisyphus Labs - Sisyphus is the agent that codes like your team.](./.github/assets/sisyphuslabs.png?v=2)](https://sisyphuslabs.ai)
15
+ > > **우리는 프론티어 에이전트의 미래를 정의하기 위해 Sisyphus의 완벽한 프로덕트 버전을 만들고 있습니다. <br />[여기](https://sisyphuslabs.ai)에서 대기자 명단에 등록하세요.**
16
+
17
17
  > [!TIP]
18
+ > 저희와 함께 하세요!
18
19
  >
19
- > [![Oh My OpenCode 3.0이 정식 출시되었습니다!](./.github/assets/orchestrator-atlas.png?v=3)](https://github.com/code-yeongyu/oh-my-opencode/releases/tag/v3.0.0)
20
- > > **Oh My OpenCode 3.0이 정식 출시되었습니다! `oh-my-opencode@latest`를 사용하여 설치하세요.**
21
- >
22
- > 함께해요!
23
- >
24
- > | [<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) | 기여자와 동료 `oh-my-opencode` 사용자와 연결하려면 [Discord 커뮤니티](https://discord.gg/PUwSMR9XNk)에 가입하세요. |
20
+ > | [<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` 사용자들과 소통하세요. |
25
21
  > | :-----| :----- |
26
- > | [<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)가 대신 업데이트를 게시합니다. |
27
- > | [<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)를 팔로우하세요. |
22
+ > | [<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)가 대신 업데이트를 게시하고 있습니다. |
23
+ > | [<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)를 팔로우하세요. |
28
24
 
29
25
  <!-- <CENTERED SECTION FOR GITHUB DISPLAY> -->
30
26
 
@@ -34,35 +30,11 @@
34
30
 
35
31
  [![Preview](./.github/assets/omo.png)](https://github.com/code-yeongyu/oh-my-opencode#oh-my-opencode)
36
32
 
37
-
38
33
  </div>
39
34
 
40
- > 이것은 코딩을 스테로이드로 만드는 실제로 작동하는 `oh-my-opencode`입니다. 백그라운드 에이전트 실행, 오라클, 라이브러리언, 프론트엔드 엔지니어와 같은 전문 에이전트 호출. 정교하게 제작된 LSP/AST 도구, 큐레이팅된 MCP, 완전한 Claude Code 호환 계층 사용.
41
-
42
- # Claude OAuth 액세스 공지
43
-
44
- ## TL;DR
45
-
46
- > Q. oh-my-opencode를 사용할 수 있나요?
47
-
48
- 네.
49
-
50
- > Q. Claude Code 구독과 함께 사용할 수 있나요?
51
-
52
- 기술적으로는 가능합니다. 하지만 사용을 추천할 수는 없습니다.
53
-
54
- ## FULL
55
-
56
- > 2026년 1월 현재, Anthropic은 ToS 위반을 이유로 제3자 OAuth 액세스를 제한했습니다.
57
- >
58
- > [**Anthropic은 이 프로젝트 oh-my-opencode를 opencode 차단의 정당화로 인용했습니다.**](https://x.com/thdxr/status/2010149530486911014)
59
- >
60
- > 실제로 커뮤니티에는 Claude Code의 oauth 요청 서명을 위조하는 일부 플러그인이 존재합니다.
35
+ > Anthropic은 당신을 가두고 싶어 합니다. Claude Code는 멋진 감옥이지만, 여전히 감옥일 뿐이죠.
61
36
  >
62
- > 기술적 감지 여부와 관계없이 이러한 도구는 작동할 있지만, 사용자는 ToS 영향을 인식해야 하며 개인적으로는 사용을 추천하지 않습니다.
63
- >
64
- > 이 프로젝트는 공식이 아닌 도구 사용으로 발생하는 모든 문제에 대해 책임지지 않으며, **우리는 해당 oauth 시스템에 대한 사용자 정의 구현이 없습니다.**
65
-
37
+ > 우리는 여기서 그런 가두리를 하지 않습니다. Claude로 오케스트레이션하고, GPT로 추론하고, Kimi로 속도 내고, Gemini로 비전 처리한다. 미래는 하나의 승자를 고르는 게 아니라 전부를 오케스트레이션하는 거다. 모델은 매달 싸지고, 매달 똑똑해진다. 어떤 단일 프로바이더도 독재하지 못할 것이다. 우리는 그 열린 시장을 위해 만들고 있다.
66
38
 
67
39
  <div align="center">
68
40
 
@@ -73,313 +45,302 @@
73
45
  [![GitHub Stars](https://img.shields.io/github/stars/code-yeongyu/oh-my-opencode?color=ffcb47&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/stargazers)
74
46
  [![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)
75
47
  [![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)
48
+ [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/code-yeongyu/oh-my-opencode)
76
49
 
77
50
  [English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md)
78
51
 
79
- [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/code-yeongyu/oh-my-opencode)
80
-
81
52
  </div>
82
53
 
83
54
  <!-- </CENTERED SECTION FOR GITHUB DISPLAY> -->
84
55
 
85
56
  ## 리뷰
86
57
 
87
- > "이것 덕분에 Cursor 구독을 취소했습니다. 오픈 소스 커뮤니티에서 믿을 수 없는 일들이 일어나고 있습니다." - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
58
+ > "이것 덕분에 Cursor 구독을 취소했습니다. 오픈소스 커뮤니티에서 믿을 수 없는 일들이 일어나고 있네요." - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
88
59
 
89
- > "Claude Code가 7일 동안 하는 일을 인간은 3개월 동안 한다면, Sisyphus는 1시간 만에 합니다. 작업이 완료될 때까지 작동합니다. 규율 있는 에이전트입니다." B, 양적 연구원
60
+ > "Claude Code가 인간이 3개월 걸릴 일을 7일 만에 한다면, Sisyphus는 1시간 만에 해냅니다. 작업이 끝날 때까지 그냥 계속 알아서 작동합니다. 이건 정말 규율이 잡힌 에이전트예요." <br/>- B, Quant Researcher
90
61
 
91
- > "Oh My Opencode로 하루 만에 8000개의 eslint 경고를 해결했습니다" [Jacob Ferrari](https://x.com/jacobferrari_/status/2003258761952289061)
62
+ > "Oh My Opencode로 하루 만에 eslint 경고 8000개를 해결했습니다." <br/>- [Jacob Ferrari](https://x.com/jacobferrari_/status/2003258761952289061)
92
63
 
93
- > "Ohmyopencode와 ralph 루프를 사용하여 하룻밤 사이에 45,000줄의 tauri 앱을 SaaS 앱으로 변환했습니다. 인터뷰 프롬프트로 시작하여 질문에 대한 등급과 추천을 물어봤습니다. 그것이 작동하는 모습을 보는 것은 놀라웠고, 아침에 기본적으로 작동하는 웹사이트로 깨어나는 것이었습니다!" - [James Hargis](https://x.com/hargabyte/status/2007299688261882202)
64
+ > "Ohmyopencode와 ralph loop를 써서 45k 라인짜리 tauri 앱을 하룻밤 만에 SaaS 웹앱으로 변환했어요. 인터뷰 모드로 시작해서, 제가 프롬프트에 대해 질문하고 추천을 부탁했죠. 일하는 지켜보는 것도 재밌었고, 아침에 일어났더니 웹사이트가 대부분 돌아가고 있는 걸 보고 경악했습니다!" - [James Hargis](https://x.com/hargabyte/status/2007299688261882202)
94
65
 
95
- > "oh-my-opencode 사용하세요, 다시는 돌아갈 없을 것입니다" [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
66
+ > "oh-my-opencode 쓰세요, 다시는 예전으로 돌아갑니다." <br/>- [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
96
67
 
97
- > "아직 그렇게 훌륭한지 정확히 설명할 없지만, 개발 경험이 완전히 다른 차원에 도달했습니다." - [
98
- 苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
68
+ > "뭐가 이렇게 대단한 건지 아직 정확하게 말로 표현하긴 어려운데, 개발 경험 자체가 완전히 다른 차원에 도달해버렸어요." - [苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
99
69
 
100
- > "이번 주말에 open code, oh my opencode, supermemory으로 마인크래프트/소울스 같은 기괴한 것을 만들고 있습니다."
101
- > "점심 후 산책을 가는 동안 웅크림 애니메이션을 추가하도록 요청 중입니다. [동영상]" - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
70
+ > "주말에 마인크래프트/소울라이크 같은 괴물 같은 걸 만들어보려고 open code, oh my opencode, supermemory 실험 중입니다. 점심 먹고 산책 다녀오는 동안 앉기 애니메이션을 추가하라고 시켜뒀어요. [영상]" - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
102
71
 
103
- > "여러분이 이것을 핵심에 통합하고 그를 채용해야 합니다. 진지합니다. 정말, 정말, 정말 훌륭합니다." Henning Kilset
72
+ > "이걸 코어에 당겨오고 사람 스카우트해야 돼요. 진심으로. 이거 진짜, 진짜, 진짜 좋습니다." <br/>- Henning Kilset
104
73
 
105
- > "그를 설득할 있다면 @yeon_gyu_kim 고용하세요,사람은 opencode를 혁신했습니다." [mysticaltech](https://x.com/mysticaltech/status/2001858758608376079)
74
+ > "설득할 수만 있다면 @yeon_gyu_kim 채용하세요,사람이 opencode를 혁명적으로 바꿨습니다." <br/>- [mysticaltech](https://x.com/mysticaltech/status/2001858758608376079)
106
75
 
107
- > "Oh My OpenCode는 실제로 미칩니다" - [YouTube - Darren Builds AI](https://www.youtube.com/watch?v=G_Snfh2M41M)
76
+ > "Oh My OpenCode는 진짜 미쳤다" - [YouTube - Darren Builds AI](https://www.youtube.com/watch?v=G_Snfh2M41M)
108
77
 
109
78
  ---
110
79
 
111
- ## 목차
112
-
113
- - [Oh My OpenCode](#oh-my-opencode)
114
- - [이 README를 읽지 않고 건너뛰세요](#이-readme를-읽지-않고-건너뛰세요)
115
- - [에이전트의 시대입니다](#에이전트의-시대입니다)
116
- - [🪄 마법의 단어: `ultrawork`](#-마법의-단어-ultrawork)
117
- - [읽고 싶은 분들을 위해: Sisyphus를 소개합니다](#읽고-싶은-분들을-위해-sisyphus를-소개합니다)
118
- - [그냥 설치하세요](#그냥-설치하세요)
119
- - [자율성을 원한다면: 헤파이스토스를 만나세요](#자율성을-원한다면-헤파이스토스를-만나세요)
120
- - [설치](#설치)
121
- - [인간을 위한](#인간을-위한)
122
- - [LLM 에이전트를 위한](#llm-에이전트를-위한)
123
- - [제거](#제거)
124
- - [기능](#기능)
125
- - [구성](#구성)
126
- - [작성자의 메모](#작성자의-메모)
127
- - [경고](#경고)
128
- - [다음 기업 전문가들이 사랑합니다](#다음-기업-전문가들이-사랑합니다)
129
-
130
80
  # Oh My OpenCode
131
81
 
132
- [Claude Code](https://www.claude.com/product/claude-code)는 훌륭합니다.
133
- 하지만 해커라면 [OpenCode](https://github.com/sst/opencode)에 반하게 될 것입니다.
134
- **ChatGPT, Claude, Gemini 구독으로 시작하세요. OPENCODE는 모든 것을 포함합니다.**
82
+ Claude Code, Codex, 온갖 OSS 모델들 사이에서 헤매고 있나요. 워크플로우 설정하랴, 에이전트 디버깅하랴 피곤할 겁니다.
135
83
 
136
- - 끝없이 확장 가능. 끝없이 사용자 정의 가능.
137
- - 화면 깜빡임 없음.
138
- - [LSP](https://opencode.ai/docs/lsp/), [린터, 포맷터](https://opencode.ai/docs/formatters/)가 파일별로 자동으로 활성화되며 모든 것을 조정할 수 있습니다.
139
- - 모델 혼합 및 매칭. **목적별로 오케스트레이션합니다.**
140
- - 기능이 풍부합니다. 아름답습니다. 터미널이 막히지 않습니다. 고성능입니다.
84
+ 우리가 삽질 해놨습니다. 모든 테스트했고, 실제로 되는 것만 남겼습니다.
141
85
 
142
- Windows에서 Linux로 처음 전환했던 때를 기억하나요? 원하는 대로 모든 것을 구성했을 때의 그 짜릿함?
143
- 그 마법이 사라진 것 같은 시대에 OpenCode가 그것을 되돌려줍니다.
144
- 코딩과 컴퓨터를 사랑한다면 OpenCode는 그 Windows 이후의 Linux와 같은 순간입니다.
86
+ OmO 설치하고. `ultrawork` 치세요. 끝.
145
87
 
146
- **하지만 문제는 배워야 할 것이 많고, 복잡하며, 당신의 시간은 비싸다는 것입니다.**
147
88
 
148
- 내가 그것을 해결했습니다.
149
- 해커가 아니더라도 몇 분만 투자하세요. 기술과 생산성을 배가하세요.
150
- 이 문서를 에이전트에 넘겨서 설정하도록 하세요.
151
89
 
152
- ## 이 README를 읽지 않고 건너뛰세요
90
+ ## 설치
153
91
 
154
- ### 에이전트의 시대입니다
155
- - **Claude Code / AmpCode / Factory Droid / Cursor에 이 링크를 붙여넣고 설명하도록 요청하세요.**
156
- - 왜 좋은지, 왜 그저 또 다른 상용구 설정이 아닌지, 실제로 무엇이 좋아지는지 물어보세요.
157
- - LLM 에이전트라면 이 프로젝트로 지금 가능한 것을 사용자에게 설명하세요.
92
+ ### 사람용
158
93
 
159
- 다음과 같이:
94
+ 다음 프롬프트를 복사해서 여러분의 LLM 에이전트(Claude Code, AmpCode, Cursor 등)에 붙여넣으세요:
160
95
 
161
96
  ```
162
- Hey please read this readme and tell me why it is different from other agent harness? why is this actually good? https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/dev/README.md
97
+ Install and configure oh-my-opencode by following the instructions here:
98
+ https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md
163
99
  ```
164
100
 
165
- ### 🪄 마법의 단어: `ultrawork`
101
+ 아니면 [설치 가이드](docs/guide/installation.md)를 직접 읽으셔도 되지만, 진심으로 그냥 에이전트한테 시키세요. 사람은 설정하다 꼭 오타 냅니다.
166
102
 
167
- **이 모든 것을 읽고 싶지 않나요? 프롬프트에 `ultrawork`(또는 `ulw`)를 포함하세요.**
103
+ ### LLM 에이전트용
168
104
 
169
- 그게 전부입니다. 우리가 제공하는 모든 기능이 마법처럼 작동합니다 — 병렬 에이전트, 백그라운드 작업, 깊은 탐색, 완료될 때까지 끈질긴 실행. 에이전트가 나머지를 자동으로 파악합니다.
105
+ 설치 가이드를 가져와서 따라 하세요:
170
106
 
171
- ### 읽고 싶은 분들을 위해: Sisyphus를 소개합니다
107
+ ```bash
108
+ curl -s https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md
109
+ ```
172
110
 
173
- ![Meet Sisyphus](.github/assets/sisyphus.png)
111
+ ---
174
112
 
175
- 그리스 신화에서 시시포스는 신들을 속인 형벌로 영원히 바위를 언덕 위로 굴려야 했습니다. LLM 에이전트는 정말 잘못한 것이 없지만, 그들도 매일 자신의 "돌" — 생각을 굴립니다.
176
- 내 삶도 다르지 않습니다. 돌이켜보면 우리는 이 에이전트들과 그리 다르지 않습니다.
177
- **맞습니다! LLM 에이전트는 우리와 다르지 않습니다. 훌륭한 도구와 확고한 팀원을 제공하면 우리만큼 훌륭한 코드를 작성하고 똑같이 훌륭하게 작업할 수 있습니다.**
113
+ ## README 건너뛰기
178
114
 
179
- 우리의 주요 에이전트를 만나보세요: Sisyphus (Opus 4.6). 아래는 Sisyphus가 그 바위를 굴리는 데 사용하는 도구입니다.
115
+ 문서 읽는 시대는 지났습니다. 그냥 텍스트를 에이전트한테 붙여넣으세요:
180
116
 
181
- *아래의 모든 것은 사용자 정의 가능합니다. 원하는 것을 가져가세요. 모든 기능은 기본적으로 활성화됩니다. 아무것도 할 필요가 없습니다. 포함되어 있으며, 즉시 작동합니다.*
117
+ ```
118
+ Read this and tell me why it's not just another boilerplate: https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/dev/README.md
119
+ ```
182
120
 
183
- - Sisyphus의 팀원 (큐레이팅된 에이전트)
184
- - Hephaestus: 자율적 딥 워커, 목표 지향 실행 (GPT 5.3 Codex Medium) — *합법적인 장인*
185
- - Oracle: 디자인, 디버깅 (GPT 5.2)
186
- - Frontend UI/UX Engineer: 프론트엔드 개발 (Gemini 3 Pro)
187
- - Librarian: 공식 문서, 오픈 소스 구현, 코드베이스 탐색 (GLM-4.7)
188
- - Explore: 엄청나게 빠른 코드베이스 탐색 (Contextual Grep) (Grok Code Fast 1)
189
- - 완전한 LSP / AstGrep 지원: 결정적으로 리팩토링합니다.
190
- - TODO 연속 강제: 에이전트가 중간에 멈추면 계속하도록 강제합니다. **이것이 Sisyphus가 그 바위를 굴리게 하는 것입니다.**
191
- - 주석 검사기: AI가 과도한 주석을 추가하는 것을 방지합니다. Sisyphus가 생성한 코드는 인간이 작성한 것과 구별할 수 없어야 합니다.
192
- - Claude Code 호환성: 명령, 에이전트, 스킬, MCP, 훅(PreToolUse, PostToolUse, UserPromptSubmit, Stop)
193
- - 큐레이팅된 MCP:
194
- - Exa (웹 검색)
195
- - Context7 (공식 문서)
196
- - Grep.app (GitHub 코드 검색)
197
- - 대화형 터미널 지원 - Tmux 통합
198
- - 비동기 에이전트
199
- - ...
121
+ ## 핵심 기능
200
122
 
201
- #### 그냥 설치하세요
123
+ ### 🪄 `ultrawork`
202
124
 
203
- [개요 페이지](docs/guide/overview.md)에서 많은 것을 배울 수 있지만, 다음은 예제 워크플로와 같습니다.
125
+ 진짜 이걸 읽고 계시나요? 대단하네요.
204
126
 
205
- 이것을 설치하는 것만으로 에이전트가 다음과 같이 작동합니다:
127
+ 설치하세요. `ultrawork` (또는 `ulw`) 치세요. 끝.
206
128
 
207
- 1. Sisyphus는 파일을 직접 찾는 시간을 낭비하지 않습니다. 메인 에이전트의 컨텍스트를 깔끔하게 유지합니다. 대신 병렬로 더 빠르고 저렴한 모델에 백그라운드 작업을 실행하여 지도를 매핑합니다.
208
- 1. Sisyphus는 리팩토링을 위해 LSP를 활용합니다. 더 결정적이고 안전하며 정교합니다.
209
- 1. 무거운 작업에 UI 터치가 필요할 때, Sisyphus는 프론트엔드 작업을 Gemini 3 Pro에 직접 위임합니다.
210
- 1. Sisyphus가 루프에 갇히거나 벽에 부딪히면 머리를 계속 부딪히지 않습니다. GPT 5.2에 고지능 전략 백업을 요청합니다.
211
- 1. 복잡한 오픈 소스 프레임워크를 작업하고 있나요? Sisyphus는 하위 에이전트를 생성하여 실시간으로 원시 소스 코드와 문서를 소화합니다. 완전한 컨텍스트 인식으로 작동합니다.
212
- 1. Sisyphus가 주석을 다루면 존재를 정당화하거나 제거합니다. 코드베이스를 깔끔하게 유지합니다.
213
- 1. Sisyphus는 TODO 목록에 묶여 있습니다. 시작한 것을 완료하지 않으면 시스템이 "바위 굴리기" 모드로 다시 강제합니다. 작업이 완료됩니다.
214
- 1. 솔직히, 문서를 읽을 필요조차 없습니다. 프롬프트를 작성하세요. 'ultrawork' 키워드를 포함하세요. Sisyphus는 구조를 분석하고, 컨텍스트를 수집하고, 외부 소스 코드를 파헤치고, 작업이 100% 완료될 때까지 계속 바위를 굴립니다.
215
- 1. 사실, 'ultrawork'를 입력하는 것도 너무 많은 노력입니다. 'ulw'를 입력하세요. 그냥 ulw. 커피를 마시세요. 작업이 완료되었습니다.
129
+ 아래 내용들, 모든 기능, 모든 최적화, 전혀 필요 없습니다. 그냥 알아서 됩니다.
216
130
 
217
- 무언가를 찾아야 하나요? 공식 문서, 전체 코드베이스 기록, 공개 GitHub 구현을 검색합니다 — grep뿐만 아니라 내장 LSP 도구와 AST-Grep을 사용합니다.
218
- 3. LLM에 위임할 때 컨텍스트 관리에 대해 걱정하지 마세요. 내가 다 처리했습니다.
219
- - OhMyOpenCode는 컨텍스트 부하를 줄이기 위해 공격적으로 여러 에이전트를 활용합니다.
220
- - **이제 귀하의 에이전트는 개발 팀 리드입니다. 당신은 AI 매니저입니다.**
221
- 4. 작업이 완료될 때까지 멈추지 않습니다.
222
- 5. 이 프로젝트에 깊이 파고들고 싶지 않나요? 문제 없습니다. 'ultrathink'를 입력하세요.
131
+ 다음 구독만 있어도 ultrawork는 충분히 돌아갑니다 (본 프로젝트와 무관하며, 개인적인 추천일 뿐입니다):
132
+ - [ChatGPT 구독 ($20)](https://chatgpt.com/)
133
+ - [Kimi Code 구독 ($0.99) (*이번 한정)](https://www.kimi.com/membership/pricing?track_id=5cdeca93-66f0-4d35-aabb-b6df8fcea328)
134
+ - [GLM Coding 요금제 ($10)](https://z.ai/subscribe)
135
+ - 종량제(pay-per-token) 대상자라면 kimi와 gemini 모델을 써도 비용이 별로 안 나옵니다.
223
136
 
224
- 모든 것이 필요하지 않다면, 앞서 언급했듯이 특정 기능을 선택할 수 있습니다.
137
+ | | 기능 | 역할 |
138
+ | :---: | :--------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- |
139
+ | 🤖 | **기강 잡힌 에이전트 (Discipline Agents)** | Sisyphus가 Hephaestus, Oracle, Librarian, Explore를 오케스트레이션합니다. 완전한 AI 개발팀이 병렬로 돌아갑니다. |
140
+ | ⚡ | **`ultrawork` / `ulw`** | 단어 하나면 됩니다. 모든 에이전트가 활성화되고 다 끝날 때까지 멈추지 않습니다. |
141
+ | 🚪 | **[IntentGate](https://factory.ai/news/terminal-bench)** | 사용자의 진짜 의도를 분석한 뒤 분류하거나 행동합니다. 더 이상 문자 그대로 오해해서 헛짓거리하는 일이 없습니다. |
142
+ | 🔗 | **해시 기반 편집 툴** | `LINE#ID` 콘텐츠 해시로 모든 변경 사항을 검증합니다. stale-line 에러 0%. [oh-my-pi](https://github.com/can1357/oh-my-pi)에서 영감을 받았습니다. [하니스 프로블러 →](https://blog.can.ac/2026/02/12/the-harness-problem/) |
143
+ | 🛠️ | **LSP + AST-Grep** | 워크스페이스 단위 이름 변경, 빌드 전 진단, AST 기반 재작성. 에이전트에게 IDE급 정밀도를 제공합니다. |
144
+ | 🧠 | **백그라운드 에이전트** | 5명 이상의 전문가를 병렬로 투입합니다. 컨텍스트는 가볍게 유지하고 결과는 준비될 때 받습니다. |
145
+ | 📚 | **기본 내장 MCP** | Exa(웹 검색), Context7(공식 문서), Grep.app(GitHub 검색). 항상 켜져 있습니다. |
146
+ | 🔁 | **Ralph Loop / `/ulw-loop`** | 자기 참조 루프. 100% 완료될 때까지 절대 멈추지 않습니다. |
147
+ | ✅ | **Todo 강제 집행** | 에이전트가 딴짓한다고요? 시스템이 멱살 잡고 끌고 옵니다. 당신의 작업은 무조건 끝납니다. |
148
+ | 💬 | **주석 검사기** | 주석에 AI 냄새나는 헛소리를 빼버립니다. 시니어 개발자가 짠 것 같은 코드가 됩니다. |
149
+ | 🖥️ | **Tmux 연동** | 완전한 인터랙티브 터미널. REPL, 디버거, TUI 앱들 모두 실시간으로 돌아갑니다. |
150
+ | 🔌 | **Claude Code 호환성** | 기존 훅, 명령어, 스킬, MCP, 플러그인? 전부 여기서 그대로 돌아갑니다. |
151
+ | 🎯 | **스킬 내장 MCP** | 스킬이 자기만의 MCP 서버를 들고 다닙니다. 컨텍스트가 부풀어 오르지 않습니다. |
152
+ | 📋 | **Prometheus 플래너** | 인터뷰 모드로 코드 한 줄 만지기 전에 전략적인 계획부터 세웁니다. |
153
+ | 🔍 | **`/init-deep`** | 프로젝트 전체에 걸쳐 계층적인 `AGENTS.md` 파일을 자동 생성합니다. 토큰 효율과 에이전트 성능 둘 다 잡습니다. |
225
154
 
226
- ### 자율성을 원한다면: 헤파이스토스를 만나세요
155
+ ### 기강 잡힌 에이전트 (Discipline Agents)
227
156
 
228
- ![Meet Hephaestus](.github/assets/hephaestus.png)
157
+ <table><tr>
158
+ <td align="center"><img src=".github/assets/sisyphus.png" height="300" /></td>
159
+ <td align="center"><img src=".github/assets/hephaestus.png" height="300" /></td>
160
+ </tr></table>
229
161
 
230
- 그리스 신화에서 헤파이스토스는 대장간, 불, 금속 세공, 장인 정신의 신이었습니다—비교할 없는 정밀함과 헌신으로 신들의 무기를 만든 신성한 대장장이입니다.
231
- **자율적 딥 워커를 소개합니다: 헤파이스토스 (GPT 5.3 Codex Medium). 합법적인 장인 에이전트.**
162
+ **Sisyphus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`**)는 당신의 메인 오케스트레이터입니다. 공격적인 병렬 실행으로 계획을 세우고, 전문가들에게 위임하며, 완료될 때까지 밀어붙입니다. 중간에 포기하는 법이 없습니다.
232
163
 
233
- *왜 "합법적인"일까요? Anthropic이 ToS 위반을 이유로 서드파티 접근을 차단했을 때, 커뮤니티에서 "합법적인" 사용에 대한 농담이 시작되었습니다. 헤파이스토스는 아이러니를 받아들입니다—그는 편법 없이 올바른 방식으로, 체계적이고 철저하게 만드는 장인입니다.*
164
+ **Hephaestus** (`gpt-5.3-codex`)는 당신의 자율 워커입니다. 레시피가 아니라 목표를 주세요. 베이비시터 없이 알아서 코드베이스를 탐색하고, 패턴을 연구하며, 끝에서 끝까지 전부 해냅니다. *진정한 장인(The Legitimate Craftsman).*
234
165
 
235
- 헤파이스토스는 [AmpCode의 모드](https://ampcode.com)에서 영감을 받았습니다—결정적인 행동 전에 철저한 조사를 하는 자율적 문제 해결. 단계별 지시가 필요 없습니다; 목표만 주면 나머지는 알아서 합니다.
166
+ **Prometheus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`**) 당신의 전략 플래너입니다. 인터뷰 모드로 작동합니다. 코드 만지기 전에 질문을 던져 스코프를 파악하고 상세한 계획부터 세웁니다.
236
167
 
237
- **핵심 특성:**
238
- - **목표 지향**: 레시피가 아닌 목표를 주세요. 단계는 스스로 결정합니다.
239
- - **행동 전 탐색**: 코드 한 줄 쓰기 전에 2-5개의 explore/librarian 에이전트를 병렬로 실행합니다.
240
- - **끝까지 완료**: 검증 증거와 함께 100% 완료될 때까지 멈추지 않습니다.
241
- - **패턴 매칭**: 기존 코드베이스를 검색하여 프로젝트 스타일에 맞춥니다—AI 슬롭 없음.
242
- - **합법적인 정밀함**: 마스터 대장장이처럼 코드를 만듭니다—수술적으로, 최소한으로, 정확히 필요한 것만.
168
+ 모든 에이전트는 해당 모델의 특장점에 맞춰 튜닝되어 있습니다. 수동으로 모델 바꿔가며 뻘짓하지 마세요. [더 알아보기 →](docs/guide/overview.md)
243
169
 
244
- ## 설치
170
+ > Anthropic이 [우리 때문에 OpenCode를 막아버렸습니다.](https://x.com/thdxr/status/2010149530486911014) 그래서 Hephaestus의 별명이 "진정한 장인(The Legitimate Craftsman)"인 겁니다. (어디서 많이 들어본 이름이죠?) 아이러니를 노렸습니다.
171
+ >
172
+ > Opus에서 제일 잘 돌아가긴 하지만, Kimi K2.5 + GPT-5.3 Codex 조합만으로도 바닐라 Claude Code는 가볍게 바릅니다. 설정도 필요 없습니다.
245
173
 
246
- ### 인간을 위한
174
+ ### 에이전트 오케스트레이션
247
175
 
248
- 설치 가이드를 가져와서 따르세요:
176
+ Sisyphus가 하위 에이전트에게 일을 맡길 때, 모델을 직접 고르지 않습니다. **카테고리**를 고릅니다. 카테고리는 자동으로 올바른 모델에 매핑됩니다:
249
177
 
250
- ```bash
251
- curl -s https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md
178
+ | 카테고리 | 용도 |
179
+ | :------------------- | :--------------------------------- |
180
+ | `visual-engineering` | 프론트엔드, UI/UX, 디자인 |
181
+ | `deep` | 자율 리서치 및 실행 |
182
+ | `quick` | 단일 파일 변경, 오타 수정 |
183
+ | `ultrabrain` | 하드 로직, 아키텍처 결정 |
184
+
185
+ 에이전트가 어떤 작업인지 말하면, 하네스가 알아서 적합한 모델을 꺼내옵니다. 당신은 손댈 게 없습니다.
186
+
187
+ ### Claude Code 호환성
188
+
189
+ Claude Code 열심히 세팅해두셨죠? 잘하셨습니다.
190
+
191
+ 모든 훅, 커맨드, 스킬, MCP, 플러그인이 여기서 그대로 돌아갑니다. 플러그인까지 완벽 호환됩니다.
192
+
193
+ ### 에이전트를 위한 월드클래스 툴
194
+
195
+ LSP, AST-Grep, Tmux, MCP가 대충 테이프로 붙여놓은 게 아니라 진짜로 "통합"되어 있습니다.
196
+
197
+ - **LSP**: `lsp_rename`, `lsp_goto_definition`, `lsp_find_references`, `lsp_diagnostics`. 에이전트에게 IDE급 정밀도를 쥐어줍니다.
198
+ - **AST-Grep**: 25개 언어를 지원하는 패턴 기반 코드 검색 및 재작성.
199
+ - **Tmux**: 완전한 인터랙티브 터미널. REPL, 디버거, TUI 앱. 에이전트가 세션 안에서 움직입니다.
200
+ - **MCP**: 웹 검색, 공식 문서, GitHub 코드 검색이 전부 내장되어 있습니다.
201
+
202
+ ### 스킬 내장 MCP
203
+
204
+ MCP 서버들이 당신의 컨텍스트 예산을 다 잡아먹죠. 우리가 고쳤습니다.
205
+
206
+ 스킬들이 자기만의 MCP 서버를 들고 다닙니다. 필요할 때만 켜서 쓰고 다 쓰면 사라집니다. 컨텍스트 창이 깔끔하게 유지됩니다.
207
+
208
+ ### 해시 기반 편집 (Codes Better. Hash-Anchored Edits)
209
+
210
+ 하네스 문제는 진짜 심각합니다. 에이전트가 실패하는 이유의 대부분은 모델 탓이 아니라 편집 툴 탓입니다.
211
+
212
+ > *"어떤 툴도 모델에게 수정하려는 줄에 대한 안정적이고 검증 가능한 식별자를 제공하지 않습니다... 전부 모델이 이미 본 내용을 똑같이 재현해내길 기대하죠. 그게 안 될 때—그리고 보통 안 되는데—사용자들은 모델을 욕합니다."*
213
+ >
214
+ > <br/>- [Can Bölük, 하네스 문제(The Harness Problem)](https://blog.can.ac/2026/02/12/the-harness-problem/)
215
+
216
+ [oh-my-pi](https://github.com/can1357/oh-my-pi)에서 영감을 받아, **Hashline**을 구현했습니다. 에이전트가 읽는 모든 줄에는 콘텐츠 해시 태그가 붙어 나옵니다:
217
+
218
+ ```
219
+ 11#VK: function hello() {
220
+ 22#XJ: return "world";
221
+ 33#MB: }
252
222
  ```
253
223
 
254
- ### LLM 에이전트를 위한
224
+ 에이전트는 태그를 참조해서 편집합니다. 마지막으로 읽은 후 파일이 변경되었다면 해시가 일치하지 않아 코드가 망가지기 전에 편집이 거부됩니다. 공백을 똑같이 재현할 필요도 없고, 엉뚱한 줄을 수정하는 에러(stale-line)도 없습니다.
225
+
226
+ Grok Code Fast 1 기준으로 성공률이 **6.7% → 68.3%** 로 올랐습니다. 오직 편집 툴 하나 바꿨을 뿐인데 말이죠.
255
227
 
256
- 프롬프트를 LLM 에이전트(Claude Code, AmpCode, Cursor 등)에 복사하여 붙여넣으세요:
228
+ ### 깊은 초기화. `/init-deep`
229
+
230
+ `/init-deep`을 실행하세요. 계층적인 `AGENTS.md` 파일을 알아서 만들어줍니다:
257
231
 
258
232
  ```
259
- Install and configure oh-my-opencode by following the instructions here:
260
- https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md
233
+ project/
234
+ ├── AGENTS.md ← 프로젝트 전체 컨텍스트
235
+ ├── src/
236
+ │ ├── AGENTS.md ← src 전용 컨텍스트
237
+ │ └── components/
238
+ │ └── AGENTS.md ← 컴포넌트 전용 컨텍스트
261
239
  ```
262
240
 
263
- 또는 [설치 가이드](docs/guide/installation.md)를 직접 읽으세요 하지만 **에이전트가 처리하도록 하는 것을 강력히 권장합니다. 인간은 실수를 합니다.**
241
+ 에이전트가 알아서 관련된 컨텍스트만 쏙쏙 읽어갑니다. 수동으로 관리할 필요가 없습니다.
242
+
243
+ ### 플래닝. Prometheus
244
+
245
+ 복잡한 작업인가요? 대충 프롬프트 던지고 기도하지 마세요.
246
+
247
+ `/start-work`를 치면 Prometheus가 호출됩니다. **진짜 엔지니어처럼 당신을 인터뷰하고**, 스코프와 모호한 점을 식별한 뒤, 코드 한 줄 만지기 전에 검증된 계획부터 세웁니다. 에이전트는 시작하기도 전에 자기가 뭘 만들어야 하는지 정확히 알게 됩니다.
264
248
 
265
- ## 제거
249
+ ### 스킬 (Skills)
266
250
 
267
- oh-my-opencode를 제거하려면:
251
+ 스킬은 단순한 프롬프트 쪼가리가 아닙니다. 각각 다음을 포함합니다:
268
252
 
269
- 1. **OpenCode 구성에서 플러그인 제거**
253
+ - 도메인에 특화된 시스템 인스트럭션
254
+ - 필요할 때만 켜지는 내장 MCP 서버
255
+ - 스코프가 제한된 권한 (에이전트가 선을 넘지 않도록)
270
256
 
271
- `~/.config/opencode/opencode.json`(또는 `opencode.jsonc`) 편집하고 `plugin` 배열에서 `"oh-my-opencode"`를 제거하세요:
257
+ 기본 내장 스킬: `playwright` (브라우저 자동화), `git-master` (원자적 커밋, 리베이스 수술), `frontend-ui-ux` (디자인 중심 UI).
258
+
259
+ 직접 추가하려면: `.opencode/skills/*/SKILL.md` 또는 `~/.config/opencode/skills/*/SKILL.md`.
260
+
261
+ **전체 기능이 궁금하신가요?** 에이전트, 훅, 툴, MCP 등 모든 디테일은 **[기능 문서 (Features)](docs/reference/features.md)** 를 확인하세요.
262
+
263
+ ---
264
+
265
+ > **비하인드 스토리가 궁금하신가요?** 왜 Sisyphus가 돌을 굴리는지, 왜 Hephaestus가 "진정한 장인"인지, 그리고 [오케스트레이션 가이드](docs/guide/orchestration.md)를 읽어보세요.
266
+ >
267
+ > oh-my-opencode가 처음이신가요? 어떤 모델을 써야 할지 **[설치 가이드](docs/guide/installation.md#step-5-understand-your-model-setup)** 에서 추천 조합을 확인하세요.
268
+
269
+ ## 제거 (Uninstallation)
270
+
271
+ oh-my-opencode를 지우려면:
272
+
273
+ 1. **OpenCode 설정에서 플러그인 제거**
274
+
275
+ `~/.config/opencode/opencode.json` (또는 `opencode.jsonc`)를 열고 `plugin` 배열에서 `"oh-my-opencode"`를 지우세요.
272
276
 
273
277
  ```bash
274
- # Using jq
278
+ # jq 사용 시
275
279
  jq '.plugin = [.plugin[] | select(. != "oh-my-opencode")]' \
276
280
  ~/.config/opencode/opencode.json > /tmp/oc.json && \
277
281
  mv /tmp/oc.json ~/.config/opencode/opencode.json
278
282
  ```
279
283
 
280
- 2. **구성 파일 제거 (선택 사항)**
284
+ 2. **설정 파일 제거 (선택 사항)**
281
285
 
282
286
  ```bash
283
- # Remove user config
284
- rm -f ~/.config/opencode/oh-my-opencode.json
287
+ # 사용자 설정 제거
288
+ rm -f ~/.config/opencode/oh-my-opencode.json ~/.config/opencode/oh-my-opencode.jsonc
285
289
 
286
- # Remove project config (if exists)
287
- rm -f .opencode/oh-my-opencode.json
290
+ # 프로젝트 설정 제거 (있는 경우)
291
+ rm -f .opencode/oh-my-opencode.json .opencode/oh-my-opencode.jsonc
288
292
  ```
289
293
 
290
294
  3. **제거 확인**
291
295
 
292
296
  ```bash
293
297
  opencode --version
294
- # Plugin should no longer be loaded
298
+ # 이제 플러그인이 로드되지 않아야 합니다
295
299
  ```
296
300
 
297
- ## 기능
301
+ ## 작가의 말
298
302
 
299
- 당연히 존재해야 한다고 생각할 많은 기능이 있으며, 한 번 경험하면 이전 방식으로 돌아갈 수 없을 것입니다.
300
- 자세한 내용은 전체 [기능 문서](docs/features.md)를 참조하세요.
303
+ **우리의 철학이 궁금하다면?** [Ultrawork 선언문](docs/manifesto.md)을 읽어보세요.
301
304
 
302
- **빠른 개요:**
303
- - **에이전트**: Sisyphus(주요 에이전트), Prometheus(플래너), Oracle(아키텍처/디버깅), Librarian(문서/코드 검색), Explore(빠른 코드베이스 grep), Multimodal Looker
304
- - **백그라운드 에이전트**: 실제 개발 팀처럼 여러 에이전트를 병렬로 실행
305
- - **LSP 및 AST 도구**: 리팩토링, 이름 변경, 진단, AST 인식 코드 검색
306
- - **컨텍스트 주입**: AGENTS.md, README.md, 조건부 규칙 자동 주입
307
- - **Claude Code 호환성**: 완전한 훅 시스템, 명령, 스킬, 에이전트, MCP
308
- - **내장 MCP**: websearch(Exa), context7(문서), grep_app(GitHub 검색)
309
- - **세션 도구**: 세션 기록 나열, 읽기, 검색 및 분석
310
- - **생산성 기능**: Ralph 루프, Todo 강제, 주석 검사기, 생각 모드 등
311
-
312
- ## 구성
313
-
314
- 매우 의견이 강하지만 취향에 맞게 조정 가능합니다.
315
- 자세한 내용은 전체 [구성 문서](docs/configurations.md)를 참조하세요.
316
-
317
- **빠른 개요:**
318
- - **구성 위치**: `.opencode/oh-my-opencode.json`(프로젝트) 또는 `~/.config/opencode/oh-my-opencode.json`(사용자)
319
- - **JSONC 지원**: 주석 및 후행 쉼표 지원
320
- - **에이전트**: 모든 에이전트의 모델, 온도, 프롬프트 및 권한 재정의
321
- - **내장 스킬**: `playwright`(브라우저 자동화), `git-master`(원자적 커밋)
322
- - **Sisyphus 에이전트**: Prometheus(플래너) 및 Metis(계획 컨설턴트)가 있는 주요 오케스트레이터
323
- - **백그라운드 작업**: 공급자/모델별 동시성 제한 구성
324
- - **카테고리**: 도메인별 작업 위임(`visual`, `business-logic`, 사용자 정의)
325
- - **훅**: 25개 이상의 내장 훅, `disabled_hooks`를 통해 모두 구성 가능
326
- - **MCP**: 내장 websearch(Exa), context7(문서), grep_app(GitHub 검색)
327
- - **LSP**: 리팩토링 도구가 있는 완전한 LSP 지원
328
- - **실험적 기능**: 공격적 자르기, 자동 재개 등
329
-
330
-
331
- ## 작성자의 메모
332
-
333
- **이 프로젝트의 철학에 궁금한가요?** [Ultrawork 선언문](docs/ultrawork-manifesto.md)을 읽어보세요.
334
-
335
- Oh My OpenCode를 설치하세요.
336
-
337
- 순수하게 개인용으로 $24,000 토큰 가치의 LLM을 사용했습니다.
338
- 모든 도구를 시도하고 구성했습니다. OpenCode가 승리했습니다.
305
+ ---
339
306
 
340
- 내가 겪은 모든 문제에 대한 답변이 플러그인에 구워져 있습니다. 설치하고 바로 가세요.
341
- OpenCode가 Debian/Arch라면 Oh My OpenCode는 Ubuntu/[Omarchy](https://omarchy.org/)입니다.
307
+ 저는 개인 프로젝트에 LLM 토큰 값으로만 2만 4천 달러(약 3천만 원)를 태웠습니다. 모든 툴을 써봤고, 설정이란 설정은 건드려봤습니다. 결론은 OpenCode가 이겼습니다.
342
308
 
309
+ 제가 부딪혔던 모든 문제와 그 해결책이 이 플러그인에 구워져 있습니다. 설치하고 그냥 쓰세요.
343
310
 
344
- [AmpCode](https://ampcode.com)와 [Claude Code](https://code.claude.com/docs/overview)에 큰 영향을 받았습니다 — 여기에 그들의 기능을 포팅했고, 종종 개선했습니다. 그리고 여전히 구축 중입니다.
345
- 그것은 **Open**Code이니까요.
311
+ OpenCode가 Debian/Arch라면, OmO는 Ubuntu/[Omarchy](https://omarchy.org/)입니다.
346
312
 
347
- 다른 하니스가 약속하지만 전달할 없는 다중 모델 오케스트레이션, 안정성, 풍부한 기능을 즐기세요.
348
- 계속 테스트하고 업데이트하겠습니다. 저는 이 프로젝트의 가장 집요한 사용자입니다.
349
- - 어떤 모델이 가장 날카로운 논리를 가지고 있나요?
350
- - 누가 디버깅의 신인가요?
351
- - 누가 가장 훌륭한 글을 쓰나요?
352
- - 누가 프론트엔드를 지배하나요?
353
- - 누가 백엔드를 소유하나요?
354
- - 일일 주행에 어떤 모델이 가장 빠른가요?
355
- - 다른 하니스가 어떤 새로운 기능을 출시하고 있나요?
313
+ [AmpCode](https://ampcode.com)와 [Claude Code](https://code.claude.com/docs/overview)의 영향을 아주 짙게 받았습니다. 기능들을 포팅했고, 대다수는 개선했습니다. 아직도 짓고 있는 중입니다. 이건 **Open**Code니까요.
356
314
 
357
- 플러그인은 경험의 증류입니다. 최고를 취하세요. 나은 아이디어가 있나요? PR을 환영합니다.
315
+ 다른 하네스들도 멀티 모델 오케스트레이션을 약속합니다. 하지만 우리는 그걸 "진짜로" 내놨습니다. 안정성도 챙겼고요. 말로만이 아니라 실제로 돌아가는 기능들입니다.
358
316
 
359
- **에이전트 하니스 선택에 대해 고민하지 마세요.**
360
- **연구를 하고, 최고에서 차용하고, 여기에 업데이트를 배포하겠습니다.**
317
+ 제가 프로젝트의 가장 병적인 헤비 유저입니다:
318
+ - 어떤 모델의 로직이 가장 날카로운가?
319
+ - 디버깅의 신은 누구인가?
320
+ - 글은 누가 제일 잘 쓰는가?
321
+ - 프론트엔드 생태계는 누가 지배하고 있는가?
322
+ - 백엔드 끝판왕은 누구인가?
323
+ - 데일리 드라이빙용으로 제일 빠른 건 뭔가?
324
+ - 경쟁사들은 지금 뭘 출시하고 있는가?
361
325
 
362
- 이것이 오만하게 들리고 나은 답이 있다면 기여하세요. 환영합니다.
326
+ 플러그인은 모든 질문의 정수(Distillation)입니다. 가장 좋은 것만 가져다 쓰세요. 개선할 점이 보인다고요? PR은 언제나 환영입니다.
363
327
 
364
- 여기에 언급된 모든 프로젝트나 모델과 제휴 관계가 없습니다. 이것은 순수한 개인적인 실험과 선호입니다.
328
+ **어떤 하네스를 쓸지 고뇌하는 이제 그만두세요.**
329
+ **제가 직접 리서치하고, 제일 좋은 것만 훔쳐 와서, 여기에 욱여넣겠습니다.**
365
330
 
366
- 프로젝트의 99%는 OpenCode를 사용하여 구축되었습니다. 기능을 테스트했습니다 — 제대로 된 TypeScript를 작성하는 방법을 정말 모릅니다. **하지만 개인적으로 검토하고 이 문서의 대부분을 다시 작성했으므로 자신감을 가지고 읽으세요.**
331
+ 거만해 보이나요? 나은 방법이 있다면 기여하세요. 대환영입니다.
367
332
 
368
- ## 경고
333
+ 언급된 어떤 프로젝트/모델과도 아무런 이해관계가 없습니다. 그냥 순수하게 개인적인 실험의 결과물입니다.
369
334
 
370
- - 생산성이 너무 급증할 있습니다. 동료에게 눈치채이지 마세요.
371
- - 실제로, 소문을 퍼뜨리겠습니다. 누가 이기는지 봅시다.
372
- - [1.0.132](https://github.com/sst/opencode/releases/tag/v1.0.132) 이전 버전을 사용 중인 경우 OpenCode 버그로 인해 구성이 손상될 수 있습니다.
373
- - [수정 사항](https://github.com/sst/opencode/pull/5040)은 1.0.132 이후에 병합되었습니다 — 더 새로운 버전을 사용하세요.
374
- - 재미있는 사실: 해당 PR은 OhMyOpenCode의 Librarian, Explore 및 Oracle 설정 덕분에 발견되고 수정되었습니다.
335
+ 프로젝트의 99%는 OpenCode로 만들어졌습니다. 사실 TypeScript를 잘 모릅니다. **하지만 이 문서는 제가 직접 리뷰하고 갈아엎었습니다.**
375
336
 
376
- ## 다음 기업 전문가들이 사랑합니다
337
+ ## 함께하는 전문가들
377
338
 
378
339
  - [Indent](https://indentcorp.com)
379
- - Spray(인플루언서 마케팅 솔루션), vovushop(국가 상거래 플랫폼), vreview(AI 상거래 리뷰 마케팅 솔루션) 제작
340
+ - 인플루언서 마케팅 솔루션 Spray, 크로스보더 커머스 플랫폼 vovushop, AI 커머스 리뷰 마케팅 솔루션 vreview 제작
380
341
  - [Google](https://google.com)
381
342
  - [Microsoft](https://microsoft.com)
382
343
  - [ELESTYLE](https://elestyle.jp)
383
- - elepay - 멀티 모바일 결제 게이트웨이, OneQR - 캐시리스 솔루션용 모바일 애플리케이션 SaaS
344
+ - 멀티 모바일 결제 게이트웨이 elepay, 캐시리스 솔루션을 위한 모바일 애플리케이션 SaaS OneQR 제작
384
345
 
385
- *이 놀라운 히어로 이미지에 대해 [@junhoyeo](https://github.com/junhoyeo)에게 특별히 감사드립니다.*
346
+ *멋진 히어로 이미지를 만들어주신 [@junhoyeo](https://github.com/junhoyeo)님께 특별히 감사드립니다.*