From 00b938d20daf5d8658d873c13ff6cd20dcd38e0b Mon Sep 17 00:00:00 2001 From: YeonGyu-Kim Date: Sun, 14 Dec 2025 17:17:02 +0900 Subject: [PATCH] docs: add missing features to README and Schema MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add hooks documentation - Add grep_app MCP documentation - Add multimodal-looker agent documentation πŸ€– GENERATED WITH ASSISTANCE OF [OhMyOpenCode](https://github.com/code-yeongyu/oh-my-opencode) --- README.ko.md | 25 ++++++++++++++++++++++--- README.md | 25 ++++++++++++++++++++++--- assets/oh-my-opencode.schema.json | 9 +++++++-- 3 files changed, 51 insertions(+), 8 deletions(-) diff --git a/README.ko.md b/README.ko.md index 04ece7c..1beb262 100644 --- a/README.ko.md +++ b/README.ko.md @@ -452,13 +452,20 @@ Oh My OpenCodeλŠ” λ‹€μŒ μœ„μΉ˜μ˜ 훅을 읽고 μ‹€ν–‰ν•©λ‹ˆλ‹€: μ—μ΄μ „νŠΈλ“€μ΄ 행볡해지면, 당신이 제일 ν–‰λ³΅ν•΄μ§‘λ‹ˆλ‹€, κ·Έλ ‡μ§€λ§Œ μ €λŠ” 당신도 λ•κ³ μ‹ΆμŠ΅λ‹ˆλ‹€. -- **Ultrawork Mode**: μ‚¬μš©μžκ°€ "ultrawork" λ˜λŠ” "ulw" ν‚€μ›Œλ“œλ₯Ό μž…λ ₯ν•˜λ©΄ μžλ™μœΌλ‘œ μ—μ΄μ „νŠΈ μ˜€μΌ€μŠ€νŠΈλ ˆμ΄μ…˜ κ°€μ΄λ“œλ₯Ό μ£Όμž…ν•©λ‹ˆλ‹€. 메인 μ—μ΄μ „νŠΈκ°€ λͺ¨λ“  κ°€μš©ν•œ μ „λ¬Έ μ—μ΄μ „νŠΈ(탐색, μ‚¬μ„œ, κ³„νš, UI)λ₯Ό λ°±κ·ΈλΌμš΄λ“œ μž‘μ—…μ„ 톡해 λ³‘λ ¬λ‘œ μ΅œλŒ€ν•œ ν™œμš©ν•˜λ„λ‘ κ°•μ œν•˜λ©°, μ—„κ²©ν•œ TODO 좔적 및 검증 ν”„λ‘œν† μ½œμ„ λ”°λ₯΄κ²Œ ν•©λ‹ˆλ‹€. κ·Έλƒ₯ ultrawork ν•˜μ„Έμš”. λ§ν•œ λͺ¨λ“  κΈ°λŠ₯이 μ΅œλŒ€λ‘œ ν™œμš©λ˜λ„λ‘ μ—μ΄μ „νŠΈκ°€ μ΅œμ ν™”λ©λ‹ˆλ‹€. +- **Keyword Detector**: ν”„λ‘¬ν”„νŠΈμ˜ ν‚€μ›Œλ“œλ₯Ό μžλ™ κ°μ§€ν•˜μ—¬ μ „λ¬Έ λͺ¨λ“œλ₯Ό ν™œμ„±ν™”ν•©λ‹ˆλ‹€: + - `ultrawork` / `ulw`: 병렬 μ—μ΄μ „νŠΈ μ˜€μΌ€μŠ€νŠΈλ ˆμ΄μ…˜μœΌλ‘œ μ΅œλŒ€ μ„±λŠ₯ λͺ¨λ“œ + - `search` / `find` / `μ°Ύμ•„` / `怜紒`: 병렬 explore/librarian μ—μ΄μ „νŠΈλ‘œ 검색 κ·ΉλŒ€ν™” + - `analyze` / `investigate` / `뢄석` / `θͺΏζŸ»`: 닀단계 μ „λ¬Έκ°€ μƒλ‹΄μœΌλ‘œ 심측 뢄석 λͺ¨λ“œ - **Todo Continuation Enforcer**: μ—μ΄μ „νŠΈκ°€ λ©ˆμΆ”κΈ° μ „ λͺ¨λ“  TODO ν•­λͺ©μ„ μ™„λ£Œν•˜λ„λ‘ κ°•μ œν•©λ‹ˆλ‹€. LLM의 고질적인 "쀑도 포기" 문제λ₯Ό λ°©μ§€ν•©λ‹ˆλ‹€. - **Comment Checker**: ν•™μŠ΅ κ³Όμ •μ˜ μŠ΅κ΄€ λ•Œλ¬ΈμΌκΉŒμš”. LLM 듀은 주석이 λ„ˆλ¬΄ λ§ŽμŠ΅λ‹ˆλ‹€. LLM 듀이 μ“Έλͺ¨μ—†λŠ” 주석을 μž‘μ„±ν•˜μ§€ μ•Šλ„λ‘ μƒκΈ°μ‹œν‚΅λ‹ˆλ‹€. BDD νŒ¨ν„΄, μ§€μ‹œμ–΄, λ…μŠ€νŠΈλ§ λ“± μœ νš¨ν•œ 주석은 λ˜‘λ˜‘ν•˜κ²Œ μ œμ™Έν•˜κ³ , 그렇지 μ•ŠλŠ” 주석듀에 λŒ€ν•΄ ν•΄λͺ…을 μš”κ΅¬ν•˜λ©° κΉ”λ”ν•œ μ½”λ“œλ₯Ό κ΅¬μ„±ν•˜κ²Œ ν•©λ‹ˆλ‹€. - **Think Mode**: ν™•μž₯된 사고(Extended Thinking)κ°€ ν•„μš”ν•œ 상황을 μžλ™μœΌλ‘œ κ°μ§€ν•˜κ³  λͺ¨λ“œλ₯Ό μ „ν™˜ν•©λ‹ˆλ‹€. μ‚¬μš©μžκ°€ κΉŠμ€ 사고λ₯Ό μš”μ²­ν•˜λŠ” ν‘œν˜„(예: "think deeply", "ultrathink")을 κ°μ§€ν•˜λ©΄, μΆ”λ‘  λŠ₯λ ₯을 κ·ΉλŒ€ν™”ν•˜λ„λ‘ λͺ¨λΈ 섀정을 λ™μ μœΌλ‘œ μ‘°μ •ν•©λ‹ˆλ‹€. - **Context Window Monitor**: [μ»¨ν…μŠ€νŠΈ μœˆλ„μš° λΆˆμ•ˆ 관리](https://agentic-patterns.com/patterns/context-window-anxiety-management/) νŒ¨ν„΄μ„ κ΅¬ν˜„ν•©λ‹ˆλ‹€. - μ‚¬μš©λŸ‰μ΄ 70%λ₯Ό λ„˜μœΌλ©΄ μ—μ΄μ „νŠΈμ—κ²Œ 아직 토큰이 μΆ©λΆ„ν•˜λ‹€κ³  μƒκΈ°μ‹œμΌœ, κΈ‰ν•˜κ²Œ λΆˆμ™„μ „ν•œ μž‘μ—…μ„ ν•˜λŠ” 것을 μ™„ν™”ν•©λ‹ˆλ‹€. -- OpenCode μ—μ„œ λˆ„λ½λ˜κ±°λ‚˜ λΆ€μ‘±ν•˜λ‹€κ³  λŠλΌλŠ” μ•ˆμ •μ„± 보강 κΈ°λŠ₯듀이 λ‚΄μž₯λ˜μ–΄μžˆμŠ΅λ‹ˆλ‹€. ν΄λ‘œλ“œ μ½”λ“œμ—μ„œμ˜ μ•ˆμ •μ μΈ κ²½ν—˜μ„ κ·ΈλŒ€λ‘œ κ°€μ Έκ°ˆ 수 μžˆμŠ΅λ‹ˆλ‹€. λŒλ‹€κ°€ μ„Έμ…˜μ΄ 망가지지 μ•ŠμŠ΅λ‹ˆλ‹€. 망가져도 λ³΅κ΅¬λ©λ‹ˆλ‹€. +- **Agent Usage Reminder**: 검색 도ꡬλ₯Ό 직접 ν˜ΈμΆœν•  λ•Œ, λ°±κ·ΈλΌμš΄λ“œ μž‘μ—…μ„ ν†΅ν•œ μ „λ¬Έ μ—μ΄μ „νŠΈ ν™œμš©μ„ ꢌμž₯ν•˜λŠ” λ¦¬λ§ˆμΈλ”λ₯Ό ν‘œμ‹œν•©λ‹ˆλ‹€. +- **Anthropic Auto Compact**: Claude λͺ¨λΈμ΄ 토큰 μ œν•œμ— λ„λ‹¬ν•˜λ©΄ μžλ™μœΌλ‘œ μ„Έμ…˜μ„ μš”μ•½ν•˜κ³  μ••μΆ•ν•©λ‹ˆλ‹€. μˆ˜λ™ κ°œμž… 없이 μž‘μ—…μ„ 계속할 수 μžˆμŠ΅λ‹ˆλ‹€. +- **Session Recovery**: μ„Έμ…˜ μ—λŸ¬(λˆ„λ½λœ 도ꡬ κ²°κ³Ό, thinking 블둝 문제, 빈 λ©”μ‹œμ§€ λ“±)μ—μ„œ μžλ™ λ³΅κ΅¬ν•©λ‹ˆλ‹€. λŒλ‹€κ°€ μ„Έμ…˜μ΄ 망가지지 μ•ŠμŠ΅λ‹ˆλ‹€. 망가져도 λ³΅κ΅¬λ©λ‹ˆλ‹€. +- **Auto Update Checker**: oh-my-opencode의 μƒˆ 버전이 μΆœμ‹œλ˜λ©΄ μ•Œλ¦Όμ„ ν‘œμ‹œν•©λ‹ˆλ‹€. +- **Background Notification**: λ°±κ·ΈλΌμš΄λ“œ μ—μ΄μ „νŠΈ μž‘μ—…μ΄ μ™„λ£Œλ˜λ©΄ μ•Œλ¦Όμ„ λ°›μŠ΅λ‹ˆλ‹€. ## μ„€μ • @@ -516,7 +523,19 @@ Google Gemini λͺ¨λΈμ„ μœ„ν•œ λ‚΄μž₯ Antigravity OAuthλ₯Ό ν™œμ„±ν™”ν•©λ‹ˆλ‹€: } ``` -μ‚¬μš© κ°€λŠ₯ν•œ μ—μ΄μ „νŠΈ: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `document-writer` +μ‚¬μš© κ°€λŠ₯ν•œ μ—μ΄μ „νŠΈ: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `document-writer`, `multimodal-looker` + +### Hooks + +`~/.config/opencode/oh-my-opencode.json` λ˜λŠ” `.opencode/oh-my-opencode.json`의 `disabled_hooks`λ₯Ό 톡해 νŠΉμ • λ‚΄μž₯ 훅을 λΉ„ν™œμ„±ν™”ν•  수 μžˆμŠ΅λ‹ˆλ‹€: + +```json +{ + "disabled_hooks": ["comment-checker", "agent-usage-reminder"] +} +``` + +μ‚¬μš© κ°€λŠ₯ν•œ ν›…: `todo-continuation-enforcer`, `context-window-monitor`, `session-recovery`, `session-notification`, `comment-checker`, `grep-output-truncator`, `tool-output-truncator`, `directory-agents-injector`, `directory-readme-injector`, `empty-task-response-detector`, `think-mode`, `anthropic-auto-compact`, `rules-injector`, `background-notification`, `auto-update-checker`, `startup-toast`, `keyword-detector`, `agent-usage-reminder` ### MCPs diff --git a/README.md b/README.md index 34bc972..d7351f7 100644 --- a/README.md +++ b/README.md @@ -453,13 +453,20 @@ All toggles default to `true` (enabled). Omit the `claude_code` object for full When agents thrive, you thrive. But I want to help you directly too. -- **Ultrawork Mode**: Type "ultrawork" or "ulw" and agent orchestration kicks in. Forces the main agent to max out all available specialists (explore, librarian, plan, UI) via background tasks in parallel, with strict TODO tracking and verification. Just ultrawork. Everything fires at full capacity. +- **Keyword Detector**: Automatically detects keywords in your prompts and activates specialized modes: + - `ultrawork` / `ulw`: Maximum performance mode with parallel agent orchestration + - `search` / `find` / `μ°Ύμ•„` / `怜紒`: Maximized search effort with parallel explore and librarian agents + - `analyze` / `investigate` / `뢄석` / `θͺΏζŸ»`: Deep analysis mode with multi-phase expert consultation - **Todo Continuation Enforcer**: Makes agents finish all TODOs before stopping. Kills the chronic LLM habit of quitting halfway. - **Comment Checker**: LLMs love comments. Too many comments. This reminds them to cut the noise. Smartly ignores valid patterns (BDD, directives, docstrings) and demands justification for the rest. Clean code wins. - **Think Mode**: Auto-detects when extended thinking is needed and switches modes. Catches phrases like "think deeply" or "ultrathink" and dynamically adjusts model settings for maximum reasoning. - **Context Window Monitor**: Implements [Context Window Anxiety Management](https://agentic-patterns.com/patterns/context-window-anxiety-management/). - At 70%+ usage, reminds agents there's still headroomβ€”prevents rushed, sloppy work. -- Stability features that felt missing in OpenCode are built in. The Claude Code experience, transplanted. Sessions don't crash mid-run. Even if they do, they recover. +- **Agent Usage Reminder**: When you call search tools directly, reminds you to leverage specialized agents via background tasks for better results. +- **Anthropic Auto Compact**: When Claude models hit token limits, automatically summarizes and compacts the sessionβ€”no manual intervention needed. +- **Session Recovery**: Automatically recovers from session errors (missing tool results, thinking block issues, empty messages). Sessions don't crash mid-run. Even if they do, they recover. +- **Auto Update Checker**: Notifies you when a new version of oh-my-opencode is available. +- **Background Notification**: Get notified when background agent tasks complete. ## Configuration @@ -517,7 +524,19 @@ Or disable via `disabled_agents` in `~/.config/opencode/oh-my-opencode.json` or } ``` -Available agents: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `document-writer` +Available agents: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `document-writer`, `multimodal-looker` + +### Hooks + +Disable specific built-in hooks via `disabled_hooks` in `~/.config/opencode/oh-my-opencode.json` or `.opencode/oh-my-opencode.json`: + +```json +{ + "disabled_hooks": ["comment-checker", "agent-usage-reminder"] +} +``` + +Available hooks: `todo-continuation-enforcer`, `context-window-monitor`, `session-recovery`, `session-notification`, `comment-checker`, `grep-output-truncator`, `tool-output-truncator`, `directory-agents-injector`, `directory-readme-injector`, `empty-task-response-detector`, `think-mode`, `anthropic-auto-compact`, `rules-injector`, `background-notification`, `auto-update-checker`, `startup-toast`, `keyword-detector`, `agent-usage-reminder` ### MCPs diff --git a/assets/oh-my-opencode.schema.json b/assets/oh-my-opencode.schema.json index 2a8eba9..50cd9a3 100644 --- a/assets/oh-my-opencode.schema.json +++ b/assets/oh-my-opencode.schema.json @@ -14,7 +14,8 @@ "type": "string", "enum": [ "websearch_exa", - "context7" + "context7", + "grep_app" ] } }, @@ -44,6 +45,7 @@ "session-notification", "comment-checker", "grep-output-truncator", + "tool-output-truncator", "directory-agents-injector", "directory-readme-injector", "empty-task-response-detector", @@ -51,7 +53,10 @@ "anthropic-auto-compact", "rules-injector", "background-notification", - "auto-update-checker" + "auto-update-checker", + "startup-toast", + "keyword-detector", + "agent-usage-reminder" ] } },