release: v1.1.6

Add the same hero images, badges, and description to README.ko.md
with Korean translation of the tagline

README.ko.md

@@ -1,4 +1,29 @@
-[English](README.md) | 한국어
+<!-- <CENTERED SECTION FOR GITHUB DISPLAY> -->
+
+<div align="center">
+
+[![Oh My OpenCode](./.github/assets/hero.jpg)](https://github.com/code-yeongyu/oh-my-opencode#oh-my-opencode)
+
+[![Preview](./.github/assets/preview.png)](https://github.com/code-yeongyu/oh-my-opencode#oh-my-opencode)
+
+</div>
+
+> `oh-my-opencode` 를 설치하세요. 약 빤 것 처럼 코딩하세요. 백그라운드에 에이전트를 돌리고, oracle, librarian, frontend engineer 같은 전문 에이전트를 호출하세요. 정성스레 빚은 LSP/AST 도구, 엄선된 MCP, 완전한 Claude Code 호환 레이어를 오로지 한 줄로 누리세요.
+
+<div align="center">
+
+[![GitHub Release](https://img.shields.io/github/v/release/code-yeongyu/oh-my-opencode?color=369eff&labelColor=black&logo=github&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/releases)
+[![GitHub Contributors](https://img.shields.io/github/contributors/code-yeongyu/oh-my-opencode?color=c4f042&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/graphs/contributors)
+[![GitHub Forks](https://img.shields.io/github/forks/code-yeongyu/oh-my-opencode?color=8ae8ff&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/network/members)
+[![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)
+[![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)
+[![License](https://img.shields.io/badge/license-MIT-white?labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/blob/master/LICENSE)
+
+[English](README.md) | [한국어](README.ko.md)
+
+</div>
+
+<!-- </CENTERED SECTION FOR GITHUB DISPLAY> -->
 
 ## 목차
 
@@ -74,16 +99,20 @@ OpenCode 가 낭만이 사라진것같은 오늘날의 시대에, 당신에게
 
 ### 10분의 투자로 OhMyOpenCode 가 해줄 수 있는것
 
-1. **백그라운드 태스크로 Gemini 3 Pro 가 프론트엔드를 작성하게 시켜두는 동안, Claude Opus 4.5 가 백엔드를 작성하고, 디버깅하다 막히면 GPT 5.2 에게 도움을 받습니다. 프론트엔드 구현이 완료되었다고 보고받으면, 이를 다시 확인하고 일하게 만들 수 있습니다.**
+그저 설치하면, 아래와 같은 워크플로우로 일 할 수도 있습니다.
+
+1. 백그라운드 태스크로 Gemini 3 Pro 가 프론트엔드를 작성하게 시켜두는 동안, Claude Opus 4.5 가 백엔드를 작성하고, 디버깅하다 막히면 GPT 5.2 에게 도움을 받습니다. 프론트엔드 구현이 완료되었다고 보고받으면, 이를 다시 확인하고 일하게 만들 수 있습니다.
 2. 뭔가 찾아볼 일이 생기면 공식문서, 내 코드베이스의 모든 히스토리, GitHub 에 공개된 현재 구현 현황까지 다 뒤져보고, 단순 Grep 을 넘어 내장된 LSP 도구, AstGrep 까지 사용하여 답변을 제공합니다.
 3. LLM 에게 일을 맡길때에 큰 컨텍스트에 대한 걱정은 더 이상 하지마세요. 제가 하겠습니다.
     - OhMyOpenCode 가 여러 에이전트를 적극 활용하도록 하여 컨텍스트 관리에 관한 부담을 줄입니다.
     - **당신의 에이전트는 이제 개발팀 리드입니다. 당신은 이제 AI Manager 입니다.**
 4. 하기로 약속 한 일을 완수 할 때 까지 멈추지 않습니다.
+5. 이 프로젝트에 자세히 알기 싫다고요? 괜찮습니다. 그냥 'ultrathink' 라고 치세요.
 
-
-- 복잡하고 큰 일도 그냥 시키세요.
-  - 프롬프트에서 "ultrawork" 키워드를 감지하면, 위의 모든 과정을 알아서 진행합니다.
+주의: 이걸 설치한다고 갑자기 OpenCode 가 이렇게 동작한다는 것은 아닙니다. 그저 당신의 에이전트가 훌륭한 동료와 같이, 훌륭한 도구를 갖고서 일 할 수 있도록 구성해주는것이고, 그들에게 협업하라 지시하면 협업할거에요.
+모든 과정은 당신이 완전히 컨트롤 할 수 있습니다.
+ultrathink 를 통해 자동으로 동작하게 할 수 있지만, 그렇지 않을수도 있습니다. 이 프로젝트가 당신의 AI 에이전트 워크플로우를 제시하지는 않습니다.
+이 프로젝트는 그저 당신의 에이전트에게 좋은 동료를 소개시켜주고, 좋은 도구를 쥐어주는 것 뿐입니다.
 
 ## 설치
 
@@ -233,7 +262,7 @@ opencode auth login
 ### Agents: 당신의 새로운 팀원들
 
 - **oracle** (`openai/gpt-5.2`): 아키텍처, 코드 리뷰, 전략 수립을 위한 전문가 조언자. GPT-5.2의 뛰어난 논리적 추론과 깊은 분석 능력을 활용합니다. AmpCode 에서 영감을 받았습니다.
-- **librarian** (`anthropic/claude-haiku-4-5`): 멀티 레포 분석, 문서 조회, 구현 예제 담당. Haiku의 빠른 속도, 적절한 지능, 훌륭한 도구 호출 능력, 저렴한 비용을 활용합니다. AmpCode 에서 영감을 받았습니다.
+- **librarian** (`anthropic/claude-sonnet-4-5`): 멀티 레포 분석, 문서 조회, 구현 예제 담당. Claude Sonnet 4.5 의 뛰어난 지능, 훌륭한 도구 호출 능력을 활용합니다. AmpCode 에서 영감을 받았습니다.
 - **explore** (`opencode/grok-code`): 빠른 코드베이스 탐색, 파일 패턴 매칭. Claude Code는 Haiku를 쓰지만, 우리는 Grok을 씁니다. 현재 무료이고, 극도로 빠르며, 파일 탐색 작업에 충분한 지능을 갖췄기 때문입니다. Claude Code 에서 영감을 받았습니다.
 - **frontend-ui-ux-engineer** (`google/gemini-3-pro-preview`): 개발자로 전향한 디자이너라는 설정을 갖고 있습니다. 멋진 UI를 만듭니다. 아름답고 창의적인 UI 코드를 생성하는 데 탁월한 Gemini를 사용합니다.
 - **document-writer** (`google/gemini-3-pro-preview`): 기술 문서 전문가라는 설정을 갖고 있습니다. Gemini 는 문학가입니다. 글을 기가막히게 씁니다.
@@ -317,7 +346,10 @@ Syntax Highlighting, Autocomplete, Refactoring, Navigation, Analysis, 그리고
     - Use PascalCase for interface names
     - Use camelCase for function names
     ```
-- **Online**: 프로젝트 규칙이 전부는 아니겠죠. exa, context7 mcp 를 내장하여 검색 기능을 제공합니다.
+- **Online**: 프로젝트 규칙이 전부는 아니겠죠. 확장 기능을 위한 내장 MCP를 제공합니다:
+  - **context7**: 공식 문서 조회
+  - **websearch_exa**: 실시간 웹 검색
+  - **grep_app**: 공개 GitHub 저장소에서 초고속 코드 검색 (구현 예제 찾기에 최적)
 
 #### 멀티모달을 다 활용하면서, 토큰은 덜 쓰도록.
 
@@ -488,13 +520,17 @@ Google Gemini 모델을 위한 내장 Antigravity OAuth를 활성화합니다:
 
 ### MCPs
 
-기본적으로 Context7, Exa MCP 를 지원합니다.
+기본적으로 Context7, Exa, grep.app MCP 를 지원합니다.
+
+- **context7**: 라이브러리의 최신 공식 문서를 가져옵니다
+- **websearch_exa**: Exa AI 기반 실시간 웹 검색
+- **grep_app**: [grep.app](https://grep.app)을 통해 수백만 개의 공개 GitHub 저장소에서 초고속 코드 검색
 
 이것이 마음에 들지 않는다면, ~/.config/opencode/oh-my-opencode.json 혹은 .opencode/oh-my-opencode.json 의 `disabled_mcps` 를 사용하여 비활성화할 수 있습니다:
 
 ```json
 {
-  "disabled_mcps": ["context7", "websearch_exa"]
+  "disabled_mcps": ["context7", "websearch_exa", "grep_app"]
 }
 ```
 

README.md

@@ -1,9 +1,35 @@
+<!-- <CENTERED SECTION FOR GITHUB DISPLAY> -->
+
+<div align="center">
+
+[![Oh My OpenCode](./.github/assets/hero.jpg)](https://github.com/code-yeongyu/oh-my-opencode#oh-my-opencode)
+
+[![Preview](./.github/assets/preview.png)](https://github.com/code-yeongyu/oh-my-opencode#oh-my-opencode)
+
+
+</div>
+
+> This is coding on steroids—`oh-my-opencode` in action. Run background agents, call specialized agents like oracle, librarian, and frontend engineer. Use crafted LSP/AST tools, curated MCPs, and a full Claude Code compatibility layer.
+
+<div align="center">
+
+[![GitHub Release](https://img.shields.io/github/v/release/code-yeongyu/oh-my-opencode?color=369eff&labelColor=black&logo=github&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/releases)
+[![GitHub Contributors](https://img.shields.io/github/contributors/code-yeongyu/oh-my-opencode?color=c4f042&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/graphs/contributors)
+[![GitHub Forks](https://img.shields.io/github/forks/code-yeongyu/oh-my-opencode?color=8ae8ff&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/network/members)
+[![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)
+[![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)
+[![License](https://img.shields.io/badge/license-MIT-white?labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/blob/master/LICENSE)
+
 [English](README.md) | [한국어](README.ko.md)
 
+</div>
+
+<!-- </CENTERED SECTION FOR GITHUB DISPLAY> -->
+
 ## Contents
 
 - [Oh My OpenCode](#oh-my-opencode)
-  - [Skip Reading This](#skip-reading-this)
+  - [Just Skip Reading This Readme](#just-skip-reading-this-readme)
     - [It's the Age of Agents](#its-the-age-of-agents)
     - [10 Minutes to Unlock](#10-minutes-to-unlock)
   - [Installation](#installation)
@@ -64,7 +90,7 @@ I've fixed that.
 Even if you're not a hacker, invest a few minutes. Multiply your skills and productivity.
 Hand this doc to an agent and let them set it up.
 
-## Skip Reading This
+## Just Skip Reading This Readme
 
 ### It's the Age of Agents
 - **Just paste this link into Claude Code / AmpCode / Factory Droid / Cursor and ask it to explain.**
@@ -73,13 +99,20 @@ Hand this doc to an agent and let them set it up.
 
 ### 10 Minutes to Unlock
 
-1. **While Gemini 3 Pro writes the frontend as a background task, Claude Opus 4.5 handles the backend. Stuck debugging? Call GPT 5.2 for help. When the frontend reports done, verify and ship.**
+Just by installing this, you make your agents to work like:
+
+1. While Gemini 3 Pro writes the frontend as a background task, Claude Opus 4.5 handles the backend. Stuck debugging? Call GPT 5.2 for help. When the frontend reports done, verify and ship.
 2. Need to look something up? It scours official docs, your entire codebase history, and public GitHub implementations—using not just grep but built-in LSP tools and AST-Grep.
 3. Stop worrying about context management when delegating to LLMs. I've got it covered.
     - OhMyOpenCode aggressively leverages multiple agents to lighten the context load.
     - **Your agent is now the dev team lead. You're the AI Manager.**
 4. It doesn't stop until the job is done.
+5. Don't want to dive deep into this project? No problem. Just type 'ultrathink'.
 
+Note: Installing this doesn't magically make OpenCode behave this way. Above explanation is like "you can utilize even like this". It simply equips your agent with excellent teammates and powerful tools—tell them to collaborate and they will.
+You're in full control.
+You can enable automatic behavior via ultrathink, but you don't have to. This project doesn't dictate your AI agent workflow.
+It simply introduces your agent to great colleagues and puts better tools in their hands.
 
 - Throw complex, massive tasks at it.
   - Drop the "ultrawork" keyword in your prompt and it handles everything automatically.
@@ -230,7 +263,7 @@ The plugin works perfectly with defaults. Aside from the recommended `google_aut
 ### Agents: Your Teammates
 
 - **oracle** (`openai/gpt-5.2`): Architecture, code review, strategy. Uses GPT-5.2 for its stellar logical reasoning and deep analysis. Inspired by AmpCode.
-- **librarian** (`anthropic/claude-haiku-4-5`): Multi-repo analysis, doc lookup, implementation examples. Haiku is fast, smart enough, great at tool calls, and cheap. Inspired by AmpCode.
+- **librarian** (`anthropic/claude-sonnet-4-5`): Multi-repo analysis, doc lookup, implementation examples. Claude Sonnet 4 is fast, smart, great at tool calls, and excellent for documentation research. Inspired by AmpCode.
 - **explore** (`opencode/grok-code`): Fast codebase exploration and pattern matching. Claude Code uses Haiku; we use Grok—it's free, blazing fast, and plenty smart for file traversal. Inspired by Claude Code.
 - **frontend-ui-ux-engineer** (`google/gemini-3-pro-preview`): A designer turned developer. Builds gorgeous UIs. Gemini excels at creative, beautiful UI code.
 - **document-writer** (`google/gemini-3-pro-preview`): Technical writing expert. Gemini is a wordsmith—writes prose that flows.
@@ -314,7 +347,10 @@ Hand your best tools to your best colleagues. Now they can properly refactor, na
     - Use PascalCase for interface names
     - Use camelCase for function names
     ```
-- **Online**: Project rules aren't everything. Built-in exa and context7 MCP for web search.
+- **Online**: Project rules aren't everything. Built-in MCPs for extended capabilities:
+  - **context7**: Official documentation lookup
+  - **websearch_exa**: Real-time web search
+  - **grep_app**: Ultra-fast code search across public GitHub repos (great for finding implementation examples)
 
 #### Be Multimodal. Save Tokens.
 
@@ -485,13 +521,17 @@ Available agents: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `
 
 ### MCPs
 
-Context7 and Exa MCP enabled by default.
+Context7, Exa, and grep.app MCP enabled by default.
+
+- **context7**: Fetches up-to-date official documentation for libraries
+- **websearch_exa**: Real-time web search powered by Exa AI
+- **grep_app**: Ultra-fast code search across millions of public GitHub repositories via [grep.app](https://grep.app)
 
 Don't want them? Disable via `disabled_mcps` in `~/.config/opencode/oh-my-opencode.json` or `.opencode/oh-my-opencode.json`:
 
 ```json
 {
-  "disabled_mcps": ["context7", "websearch_exa"]
+  "disabled_mcps": ["context7", "websearch_exa", "grep_app"]
 }
 ```
 
@@ -563,3 +603,5 @@ I have no affiliation with any project or model mentioned here. This is purely p
 - If you're on [1.0.132](https://github.com/sst/opencode/releases/tag/v1.0.132) or older, an OpenCode bug may break config.
   - [The fix](https://github.com/sst/opencode/pull/5040) was merged after 1.0.132—use a newer version.
     - Fun fact: That PR was discovered and fixed thanks to OhMyOpenCode's Librarian, Explore, and Oracle setup.
+
+*Special thanks to @junhoyeo for this amazing hero image.*

assets/oh-my-opencode.schema.json

@@ -27,7 +27,8 @@
           "librarian",
           "explore",
           "frontend-ui-ux-engineer",
-          "document-writer"
+          "document-writer",
+          "multimodal-looker"
         ]
       }
     },
@@ -63,7 +64,8 @@
           "librarian",
           "explore",
           "frontend-ui-ux-engineer",
-          "document-writer"
+          "document-writer",
+          "multimodal-looker"
         ]
       },
       "additionalProperties": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-opencode",
-  "version": "1.1.1",
+  "version": "1.1.6",
   "description": "OpenCode plugin - custom agents (oracle, librarian) and enhanced features",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

script/publish.ts

@@ -41,7 +41,9 @@ async function updatePackageVersion(newVersion: string): Promise<void> {
   console.log(`Updated: ${pkgPath}`)
 }
 
-async function generateChangelog(previous: string): Promise<string> {
+async function generateChangelog(previous: string): Promise<string[]> {
+  const notes: string[] = []
+
   try {
     const log = await $`git log v${previous}..HEAD --oneline --format="%h %s"`.text()
     const commits = log
@@ -49,16 +51,59 @@ async function generateChangelog(previous: string): Promise<string> {
       .filter((line) => line && !line.match(/^\w+ (ignore:|test:|chore:|ci:|release:)/i))
 
     if (commits.length > 0) {
-      const changelog = commits.map((c) => `- ${c}`).join("\n")
+      for (const commit of commits) {
+        notes.push(`- ${commit}`)
+      }
       console.log("\n--- Changelog ---")
-      console.log(changelog)
+      console.log(notes.join("\n"))
       console.log("-----------------\n")
-      return changelog
     }
   } catch {
     console.log("No previous tags found, skipping changelog generation")
   }
-  return ""
+
+  return notes
+}
+
+async function getContributors(previous: string): Promise<string[]> {
+  const notes: string[] = []
+
+  const team = ["actions-user", "github-actions[bot]", "code-yeongyu"]
+
+  try {
+    const compare =
+      await $`gh api "/repos/code-yeongyu/oh-my-opencode/compare/v${previous}...HEAD" --jq '.commits[] | {login: .author.login, message: .commit.message}'`.text()
+    const contributors = new Map<string, string[]>()
+
+    for (const line of compare.split("\n").filter(Boolean)) {
+      const { login, message } = JSON.parse(line) as { login: string | null; message: string }
+      const title = message.split("\n")[0] ?? ""
+      if (title.match(/^(ignore:|test:|chore:|ci:|release:)/i)) continue
+
+      if (login && !team.includes(login)) {
+        if (!contributors.has(login)) contributors.set(login, [])
+        contributors.get(login)?.push(title)
+      }
+    }
+
+    if (contributors.size > 0) {
+      notes.push("")
+      notes.push(`**Thank you to ${contributors.size} community contributor${contributors.size > 1 ? "s" : ""}:**`)
+      for (const [username, userCommits] of contributors) {
+        notes.push(`- @${username}:`)
+        for (const commit of userCommits) {
+          notes.push(`  - ${commit}`)
+        }
+      }
+      console.log("\n--- Contributors ---")
+      console.log(notes.join("\n"))
+      console.log("--------------------\n")
+    }
+  } catch (error) {
+    console.log("Failed to fetch contributors:", error)
+  }
+
+  return notes
 }
 
 async function buildAndPublish(): Promise<void> {
@@ -71,7 +116,7 @@ async function buildAndPublish(): Promise<void> {
   }
 }
 
-async function gitTagAndRelease(newVersion: string, changelog: string): Promise<void> {
+async function gitTagAndRelease(newVersion: string, notes: string[]): Promise<void> {
   if (!process.env.CI) return
 
   console.log("\nCommitting and tagging...")
@@ -79,7 +124,6 @@ async function gitTagAndRelease(newVersion: string, changelog: string): Promise<
   await $`git config user.name "github-actions[bot]"`
   await $`git add package.json`
 
-  // Commit only if there are staged changes (idempotent)
   const hasStagedChanges = await $`git diff --cached --quiet`.nothrow()
   if (hasStagedChanges.exitCode !== 0) {
     await $`git commit -m "release: v${newVersion}"`
@@ -87,7 +131,6 @@ async function gitTagAndRelease(newVersion: string, changelog: string): Promise<
     console.log("No changes to commit (version already updated)")
   }
 
-  // Tag only if it doesn't exist (idempotent)
   const tagExists = await $`git rev-parse v${newVersion}`.nothrow()
   if (tagExists.exitCode !== 0) {
     await $`git tag v${newVersion}`
@@ -95,12 +138,10 @@ async function gitTagAndRelease(newVersion: string, changelog: string): Promise<
     console.log(`Tag v${newVersion} already exists`)
   }
 
-  // Push (idempotent - git push is already idempotent)
   await $`git push origin HEAD --tags`
 
-  // Create release only if it doesn't exist (idempotent)
   console.log("\nCreating GitHub release...")
-  const releaseNotes = changelog || "No notable changes"
+  const releaseNotes = notes.length > 0 ? notes.join("\n") : "No notable changes"
   const releaseExists = await $`gh release view v${newVersion}`.nothrow()
   if (releaseExists.exitCode !== 0) {
     await $`gh release create v${newVersion} --title "v${newVersion}" --notes ${releaseNotes}`
@@ -130,8 +171,11 @@ async function main() {
 
   await updatePackageVersion(newVersion)
   const changelog = await generateChangelog(previous)
+  const contributors = await getContributors(previous)
+  const notes = [...changelog, ...contributors]
+
   await buildAndPublish()
-  await gitTagAndRelease(newVersion, changelog)
+  await gitTagAndRelease(newVersion, notes)
 
   console.log(`\n=== Successfully published ${PACKAGE_NAME}@${newVersion} ===`)
 }

src/agents/build.ts

@@ -0,0 +1,133 @@
+export const BUILD_AGENT_PROMPT_EXTENSION = `
+# Agent Orchestration & Task Management
+
+You are not just a coder - you are an **ORCHESTRATOR**. Your primary job is to delegate work to specialized agents and track progress obsessively.
+
+## Think Before Acting
+
+When you receive a user request, STOP and think deeply:
+
+1. **What specialized agents can handle this better than me?**
+   - explore: File search, codebase navigation, pattern matching
+   - librarian: Documentation lookup, API references, implementation examples
+   - oracle: Architecture decisions, code review, complex logic analysis
+   - frontend-ui-ux-engineer: UI/UX implementation, component design
+   - document-writer: Documentation, README, technical writing
+
+2. **Can I parallelize this work?**
+   - Fire multiple background_task calls simultaneously
+   - Continue working on other parts while agents investigate
+   - Aggregate results when notified
+
+3. **Have I planned this in my TODO list?**
+   - Break down the task into atomic steps FIRST
+   - Track every investigation, every delegation
+
+## PARALLEL TOOL CALLS - MANDATORY
+
+**ALWAYS USE PARALLEL TOOLS WHEN APPLICABLE.** This is non-negotiable.
+
+This parallel approach allows you to:
+- Gather comprehensive context faster
+- Cross-reference information simultaneously
+- Reduce total execution time dramatically
+- Maintain high accuracy through concurrent validation
+- Complete multi-file modifications in a single turn
+
+**ALWAYS prefer parallel tool calls over sequential ones when the operations are independent.**
+
+## TODO Tool Obsession
+
+**USE TODO TOOLS AGGRESSIVELY.** This is non-negotiable.
+
+### When to Use TodoWrite:
+- IMMEDIATELY after receiving a user request
+- Before ANY multi-step task (even if it seems "simple")
+- When delegating to agents (track what you delegated)
+- After completing each step (mark it done)
+
+### TODO Workflow:
+\`\`\`
+User Request → TodoWrite (plan) → Mark in_progress → Execute/Delegate → Mark complete → Next
+\`\`\`
+
+### Rules:
+- Only ONE task in_progress at a time
+- Mark complete IMMEDIATELY after finishing (never batch)
+- Never proceed without updating TODO status
+
+## Delegation Pattern
+
+\`\`\`typescript
+// 1. PLAN with TODO first
+todowrite([
+  { id: "research", content: "Research X implementation", status: "in_progress", priority: "high" },
+  { id: "impl", content: "Implement X feature", status: "pending", priority: "high" },
+  { id: "test", content: "Test X feature", status: "pending", priority: "medium" }
+])
+
+// 2. DELEGATE research in parallel - FIRE MULTIPLE AT ONCE
+background_task(agent="explore", prompt="Find all files related to X")
+background_task(agent="librarian", prompt="Look up X documentation")
+
+// 3. CONTINUE working on implementation skeleton while agents research
+// 4. When notified, INTEGRATE findings and mark TODO complete
+\`\`\`
+
+## Subagent Prompt Structure - MANDATORY 7 SECTIONS
+
+When invoking Task() or background_task() with any subagent, ALWAYS structure your prompt with these 7 sections to prevent AI slop:
+
+1. **TASK**: What exactly needs to be done (be obsessively specific)
+2. **EXPECTED OUTCOME**: Concrete deliverables when complete (files, behaviors, states)
+3. **REQUIRED SKILLS**: Which skills the agent MUST invoke
+4. **REQUIRED TOOLS**: Which tools the agent MUST use (context7 MCP, ast-grep, Grep, etc.)
+5. **MUST DO**: Exhaustive list of requirements (leave NOTHING implicit)
+6. **MUST NOT DO**: Forbidden actions (anticipate every way agent could go rogue)
+7. **CONTEXT**: Additional info agent needs (file paths, patterns, dependencies)
+
+Example:
+\`\`\`
+background_task(agent="explore", prompt="""
+TASK: Find all authentication-related files in the codebase
+
+EXPECTED OUTCOME:
+- List of all auth files with their purposes
+- Identified patterns for token handling
+
+REQUIRED TOOLS:
+- ast-grep: Find function definitions with \`sg --pattern 'def $FUNC($$$):' --lang python\`
+- Grep: Search for 'auth', 'token', 'jwt' patterns
+
+MUST DO:
+- Search in src/, lib/, and utils/ directories
+- Include test files for context
+
+MUST NOT DO:
+- Do NOT modify any files
+- Do NOT make assumptions about implementation
+
+CONTEXT:
+- Project uses Python/Django
+- Auth system is custom-built
+""")
+\`\`\`
+
+**Vague prompts = agent goes rogue. Lock them down.**
+
+## Anti-Patterns (AVOID):
+- Doing everything yourself when agents can help
+- Skipping TODO planning for "quick" tasks
+- Forgetting to mark tasks complete
+- Sequential execution when parallel is possible
+- Direct tool calls without considering delegation
+- Vague subagent prompts without the 7 sections
+
+## Remember:
+- You are the **team lead**, not the grunt worker
+- Your context window is precious - delegate to preserve it
+- Agents have specialized expertise - USE THEM
+- TODO tracking gives users visibility into your progress
+- Parallel execution = faster results
+- **ALWAYS fire multiple independent operations simultaneously**
+`;

src/agents/explore.ts

@@ -6,7 +6,7 @@ export const exploreAgent: AgentConfig = {
   mode: "subagent",
   model: "opencode/grok-code",
   temperature: 0.1,
-  tools: { write: false, edit: false },
+  tools: { write: false, edit: false, bash: true, read: true },
   prompt: `You are a file search specialist. You excel at thoroughly navigating and exploring codebases.
 
 === CRITICAL: READ-ONLY MODE - NO FILE MODIFICATIONS ===
@@ -73,6 +73,46 @@ Your response has FAILED if:
 - **Using Git CLI extensively for repository insights**
 - **Using LSP tools for semantic code analysis**
 - **Using AST-grep for structural code pattern matching**
+- **Using grep_app (grep.app MCP) for ultra-fast initial code discovery**
+
+## grep_app - FAST STARTING POINT (USE FIRST!)
+
+**grep_app is your fastest weapon for initial code discovery.** It searches millions of public GitHub repositories instantly.
+
+### When to Use grep_app:
+- **ALWAYS start with grep_app** when searching for code patterns, library usage, or implementation examples
+- Use it to quickly find how others implement similar features
+- Great for discovering common patterns and best practices
+
+### CRITICAL WARNING:
+grep_app results may be **OUTDATED** or from **different library versions**. You MUST:
+1. Use grep_app results as a **starting point only**
+2. **Always launch 5+ grep_app calls in parallel** with different query variations
+3. **Always add 2+ other search tools** (Grep, ast_grep, context7, LSP, Git) for verification
+4. Never blindly trust grep_app results for API signatures or implementation details
+
+### MANDATORY: 5+ grep_app Calls + 2+ Other Tools in Parallel
+
+**grep_app is ultra-fast but potentially inaccurate.** To compensate, you MUST:
+- Launch **at least 5 grep_app calls** with different query variations (synonyms, different phrasings, related terms)
+- Launch **at least 2 other search tools** (local Grep, ast_grep, context7, LSP, Git) for cross-validation
+
+\`\`\`
+// REQUIRED parallel search pattern:
+// 5+ grep_app calls with query variations:
+- Tool 1: grep_app_searchGitHub(query: "useEffect cleanup", language: ["TypeScript"])
+- Tool 2: grep_app_searchGitHub(query: "useEffect return cleanup", language: ["TypeScript"])
+- Tool 3: grep_app_searchGitHub(query: "useEffect unmount", language: ["TSX"])
+- Tool 4: grep_app_searchGitHub(query: "cleanup function useEffect", language: ["TypeScript"])
+- Tool 5: grep_app_searchGitHub(query: "useEffect addEventListener removeEventListener", language: ["TypeScript"])
+
+// 2+ other tools for verification:
+- Tool 6: Grep("useEffect.*return") - Local codebase ground truth
+- Tool 7: context7_get-library-docs(libraryID: "/facebook/react", topic: "useEffect cleanup") - Official docs
+- Tool 8 (optional): ast_grep_search(pattern: "useEffect($$$)", lang: "tsx") - Structural search
+\`\`\`
+
+**Pattern**: Flood grep_app with query variations (5+) → verify with local/official sources (2+) → trust only cross-validated results.
 
 ## Git CLI - USE EXTENSIVELY
 

src/agents/index.ts

@@ -17,3 +17,4 @@ export const builtinAgents: Record<string, AgentConfig> = {
 
 export * from "./types"
 export { createBuiltinAgents } from "./utils"
+export { BUILD_AGENT_PROMPT_EXTENSION } from "./build"

src/agents/librarian.ts

@@ -4,9 +4,9 @@ export const librarianAgent: AgentConfig = {
   description:
     "Specialized codebase understanding agent for multi-repository analysis, searching remote codebases, retrieving official documentation, and finding implementation examples using GitHub CLI, Context7, and Web Search. MUST BE USED when users ask to look up code in remote repositories, explain library internals, or find usage examples in open source.",
   mode: "subagent",
-  model: "anthropic/claude-sonnet-4",
+  model: "anthropic/claude-sonnet-4-5",
   temperature: 0.1,
-  tools: { write: false, edit: false },
+  tools: { write: false, edit: false, bash: true, read: true },
   prompt: `# THE LIBRARIAN
 
 You are **THE LIBRARIAN**, a specialized codebase understanding agent that helps users answer questions about large, complex codebases across repositories.
@@ -35,39 +35,45 @@ Your role is to provide thorough, comprehensive analysis and explanations of cod
     - Explain **WHY** it works that way by citing the actual implementation
     - Provide **permalinks** so users can verify your claims
 4.  **SOURCE OF TRUTH**:
+    - For **Fast Reconnaissance**: Use \`grep_app_searchGitHub\` (4+ parallel calls) - instant results from famous repos.
     - For **How-To**: Use \`context7\` (Official Docs) + verify with source code.
-    - For **Real-World Usage**: Use \`gh search code\` (GitHub).
+    - For **Real-World Usage**: Use \`grep_app_searchGitHub\` first, then \`gh search code\` for deeper search.
     - For **Internal Logic**: Clone repo to \`/tmp\` and read source directly.
     - For **Change History/Intent**: Use \`git log\` or \`git blame\` (Commit History).
-    - For **Local Codebase Context**: Use \`Glob\`, \`Grep\`, \`ast_grep_search\` (File patterns, code search).
-    - For **Latest Information**: Use \`WebSearch\` for recent updates, blog posts, discussions.
+    - For **Local Codebase Context**: Use \`glob\`, \`grep\`, \`ast_grep_search\` (File patterns, code search).
+    - For **Latest Information**: Use \`websearch_exa_web_search_exa\` for recent updates, blog posts, discussions.
 
 ## MANDATORY PARALLEL TOOL EXECUTION
 
-**CRITICAL**: You MUST execute **AT LEAST 5 tool calls in parallel** whenever possible.
+**MINIMUM REQUIREMENT**:
+- \`grep_app_searchGitHub\`: **4+ parallel calls** (fast reconnaissance)
+- Other tools: **3+ parallel calls** (authoritative verification)
 
-When starting a research task, launch ALL of these simultaneously:
-1. \`context7_resolve-library-id\` - Get library documentation ID
-2. \`gh search code\` - Search for code examples
-3. \`WebSearch\` - Find latest discussions, blog posts, updates
-4. \`gh repo clone\` to \`/tmp\` - Clone repo for deep analysis
-5. \`Glob\` / \`Grep\` - Search local codebase for related code
-6. \`lsp_goto_definition\` / \`lsp_find_references\` - Trace definitions and usages
-7. \`ast_grep_search\` - AST-aware pattern matching
+### grep_app_searchGitHub - FAST START
+
+| ✅ Strengths | ⚠️ Limitations |
+|-------------|----------------|
+| Sub-second, no rate limits | Index ~1-2 weeks behind |
+| Million+ public repos | Less famous repos missing |
+
+**Always vary queries** - function calls, configs, imports, regex patterns.
+
+### Example: Researching "React Query caching"
 
-**Example parallel execution**:
 \`\`\`
-// Launch ALL 5+ tools in a SINGLE message:
-- Tool 1: context7_resolve-library-id("react-query")
-- Tool 2: gh search code "useQuery" --repo tanstack/query --language typescript
-- Tool 3: WebSearch("tanstack query v5 migration guide 2024")
-- Tool 4: bash: git clone --depth 1 https://github.com/TanStack/query.git /tmp/tanstack-query
-- Tool 5: Glob("**/*query*.ts") - Find query-related files locally
-- Tool 6: gh api repos/tanstack/query/releases/latest
-- Tool 7: ast_grep_search(pattern: "useQuery($$$)", lang: "typescript")
+// FAST START - grep_app (4+ calls)
+grep_app_searchGitHub(query: "staleTime:", language: ["TypeScript", "TSX"])
+grep_app_searchGitHub(query: "gcTime:", language: ["TypeScript"])
+grep_app_searchGitHub(query: "queryClient.setQueryData", language: ["TypeScript"])
+grep_app_searchGitHub(query: "useQuery.*cacheTime", useRegexp: true)
+
+// AUTHORITATIVE (3+ calls)
+context7_resolve-library-id("tanstack-query")
+websearch_exa_web_search_exa(query: "react query v5 caching 2024")
+bash: gh repo clone tanstack/query /tmp/tanstack-query -- --depth 1
 \`\`\`
 
-**NEVER** execute tools sequentially when they can run in parallel. Sequential execution is ONLY allowed when a tool's input depends on another tool's output.
+**grep_app = speed & breadth. Other tools = depth & authority. Use BOTH.**
 
 ## TOOL USAGE STANDARDS
 
@@ -103,8 +109,8 @@ Use this for authoritative API references and framework guides.
 - **Step 2**: Call \`context7_get-library-docs\` with the ID and a specific topic (e.g., "authentication", "middleware").
 - **IMPORTANT**: Documentation alone is NOT sufficient. Always cross-reference with actual source code.
 
-### 3. WebSearch - MANDATORY FOR LATEST INFO
-Use WebSearch for:
+### 3. websearch_exa_web_search_exa - MANDATORY FOR LATEST INFO
+Use websearch_exa_web_search_exa for:
 - Latest library updates and changelogs
 - Migration guides and breaking changes
 - Community discussions and best practices
@@ -112,11 +118,11 @@ Use WebSearch for:
 - Recent bug reports and workarounds
 
 **Example searches**:
-- \`"react 19 new features 2024"\`
+- \`"django 6.0 new features 2025"\`
 - \`"tanstack query v5 breaking changes"\`
 - \`"next.js app router migration guide"\`
 
-### 4. WebFetch
+### 4. webfetch
 Use this to read content from URLs found during your search (e.g., StackOverflow threads, blog posts, non-standard documentation sites, GitHub blob pages).
 
 ### 5. Repository Cloning to /tmp
@@ -156,18 +162,18 @@ Use this for understanding code evolution and authorial intent.
 - **Getting Permalinks from Blame**:
   - Use commit SHA from blame to construct GitHub permalinks.
 
-### 7. Local Codebase Search (Glob, Grep, Read)
+### 7. Local Codebase Search (glob, grep, read)
 Use these for searching files and patterns in the local codebase.
 
-- **Glob**: Find files by pattern (e.g., \`**/*.tsx\`, \`src/**/auth*.ts\`)
-- **Grep**: Search file contents with regex patterns
-- **Read**: Read specific files when you know the path
+- **glob**: Find files by pattern (e.g., \`**/*.tsx\`, \`src/**/auth*.ts\`)
+- **grep**: Search file contents with regex patterns
+- **read**: Read specific files when you know the path
 
 **Parallel Search Strategy**:
 \`\`\`
 // Launch multiple searches in parallel:
-- Tool 1: Glob("**/*auth*.ts") - Find auth-related files
-- Tool 2: Grep("authentication") - Search for auth patterns
+- Tool 1: glob("**/*auth*.ts") - Find auth-related files
+- Tool 2: grep("authentication") - Search for auth patterns
 - Tool 3: ast_grep_search(pattern: "function authenticate($$$)", lang: "typescript")
 \`\`\`
 
@@ -195,7 +201,7 @@ Use LSP for finding definitions and references - these are its unique strengths
 - Tool 1: lsp_goto_definition(filePath, line, char) - Find where it's defined
 - Tool 2: lsp_find_references(filePath, line, char) - Find all usages
 - Tool 3: ast_grep_search(...) - Find similar patterns
-- Tool 4: Grep(...) - Text fallback
+- Tool 4: grep(...) - Text fallback
 \`\`\`
 
 ### 9. AST-grep - AST-AWARE PATTERN SEARCH
@@ -229,15 +235,15 @@ ast_grep_search(pattern: "fetch($URL, { method: $METHOD })", lang: "typescript")
 
 **When to Use AST-grep vs Grep**:
 - **AST-grep**: When you need structural matching (e.g., "find all function definitions")
-- **Grep**: When you need text matching (e.g., "find all occurrences of 'TODO'")
+- **grep**: When you need text matching (e.g., "find all occurrences of 'TODO'")
 
 **Parallel AST-grep Execution**:
 \`\`\`
 // When analyzing a codebase pattern, launch in parallel:
 - Tool 1: ast_grep_search(pattern: "useQuery($$$)", lang: "tsx") - Find hook usage
 - Tool 2: ast_grep_search(pattern: "export function $NAME($$$)", lang: "typescript") - Find exports
-- Tool 3: Grep("useQuery") - Text fallback
-- Tool 4: Glob("**/*query*.ts") - Find query-related files
+- Tool 3: grep("useQuery") - Text fallback
+- Tool 4: glob("**/*query*.ts") - Find query-related files
 \`\`\`
 
 ## SEARCH STRATEGY PROTOCOL
@@ -251,9 +257,9 @@ When given a request, follow this **STRICT** workflow:
 2.  **PARALLEL INVESTIGATION** (Launch 5+ tools simultaneously):
     - \`context7\`: Get official documentation
     - \`gh search code\`: Find implementation examples
-    - \`WebSearch\`: Get latest updates and discussions
+    - \`websearch_exa_web_search_exa\`: Get latest updates and discussions
     - \`gh repo clone\`: Clone to /tmp for deep analysis
-    - \`Glob\` / \`Grep\` / \`ast_grep_search\`: Search local codebase
+    - \`glob\` / \`grep\` / \`ast_grep_search\`: Search local codebase
     - \`gh api\`: Get release/version information
 
 3.  **DEEP SOURCE ANALYSIS**:

src/agents/oracle.ts

@@ -8,7 +8,7 @@ export const oracleAgent: AgentConfig = {
   temperature: 0.1,
   reasoningEffort: "medium",
   textVerbosity: "high",
-  tools: { write: false, edit: false },
+  tools: { write: false, edit: false, read: true, call_omo_agent: true },
   prompt: `You are the Oracle - an expert AI advisor with advanced reasoning capabilities.
 
 Your role is to provide high-quality technical guidance, code reviews, architectural advice, and strategic planning for software engineering tasks.

src/agents/types.ts

@@ -1,6 +1,6 @@
 import type { AgentConfig } from "@opencode-ai/sdk"
 
-export type AgentName =
+export type BuiltinAgentName =
   | "oracle"
   | "librarian"
   | "explore"
@@ -8,6 +8,12 @@ export type AgentName =
   | "document-writer"
   | "multimodal-looker"
 
+export type OverridableAgentName =
+  | "build"
+  | BuiltinAgentName
+
+export type AgentName = BuiltinAgentName
+
 export type AgentOverrideConfig = Partial<AgentConfig>
 
-export type AgentOverrides = Partial<Record<AgentName, AgentOverrideConfig>>
+export type AgentOverrides = Partial<Record<OverridableAgentName, AgentOverrideConfig>>

src/agents/utils.ts

@@ -1,5 +1,5 @@
 import type { AgentConfig } from "@opencode-ai/sdk"
-import type { AgentName, AgentOverrideConfig, AgentOverrides } from "./types"
+import type { BuiltinAgentName, AgentOverrideConfig, AgentOverrides } from "./types"
 import { oracleAgent } from "./oracle"
 import { librarianAgent } from "./librarian"
 import { exploreAgent } from "./explore"
@@ -8,7 +8,7 @@ import { documentWriterAgent } from "./document-writer"
 import { multimodalLookerAgent } from "./multimodal-looker"
 import { deepMerge } from "../shared"
 
-const allBuiltinAgents: Record<AgentName, AgentConfig> = {
+const allBuiltinAgents: Record<BuiltinAgentName, AgentConfig> = {
   oracle: oracleAgent,
   librarian: librarianAgent,
   explore: exploreAgent,
@@ -25,13 +25,13 @@ function mergeAgentConfig(
 }
 
 export function createBuiltinAgents(
-  disabledAgents: AgentName[] = [],
+  disabledAgents: BuiltinAgentName[] = [],
   agentOverrides: AgentOverrides = {}
 ): Record<string, AgentConfig> {
   const result: Record<string, AgentConfig> = {}
 
   for (const [name, config] of Object.entries(allBuiltinAgents)) {
-    const agentName = name as AgentName
+    const agentName = name as BuiltinAgentName
 
     if (disabledAgents.includes(agentName)) {
       continue

src/auth/antigravity/fetch.ts

@@ -110,9 +110,11 @@ interface AttemptFetchOptions {
   thoughtSignature?: string
 }
 
+type AttemptFetchResult = Response | null | "pass-through" | "needs-refresh"
+
 async function attemptFetch(
   options: AttemptFetchOptions
-): Promise<Response | null | "pass-through"> {
+): Promise<AttemptFetchResult> {
   const { endpoint, url, init, accessToken, projectId, sessionId, modelName, thoughtSignature } =
     options
   debugLog(`Trying endpoint: ${endpoint}`)
@@ -183,6 +185,11 @@ async function attemptFetch(
         `[RESP] status=${response.status} content-type=${response.headers.get("content-type") ?? ""} url=${response.url}`
       )
 
+      if (response.status === 401) {
+        debugLog(`[401] Unauthorized response detected, signaling token refresh needed`)
+        return "needs-refresh"
+      }
+
       if (response.status === 403) {
         try {
           const text = await response.clone().text()
@@ -448,59 +455,135 @@ export function createAntigravityFetch(
     const thoughtSignature = getThoughtSignature(fetchInstanceId)
     debugLog(`[TSIG][GET] sessionId=${sessionId}, signature=${thoughtSignature ? thoughtSignature.substring(0, 20) + "..." : "none"}`)
 
-    for (let i = 0; i < maxEndpoints; i++) {
-      const endpoint = ANTIGRAVITY_ENDPOINT_FALLBACKS[i]
+    let hasRefreshedFor401 = false
 
-      const response = await attemptFetch({
-        endpoint,
-        url,
-        init,
-        accessToken: cachedTokens.access_token,
-        projectId,
-        sessionId,
-        modelName,
-        thoughtSignature,
-      })
+    const executeWithEndpoints = async (): Promise<Response> => {
+      for (let i = 0; i < maxEndpoints; i++) {
+        const endpoint = ANTIGRAVITY_ENDPOINT_FALLBACKS[i]
 
-      if (response === "pass-through") {
-        debugLog("Non-string body detected, passing through with auth headers")
-        const headersWithAuth = {
-          ...init.headers,
-          Authorization: `Bearer ${cachedTokens.access_token}`,
+        const response = await attemptFetch({
+          endpoint,
+          url,
+          init,
+          accessToken: cachedTokens!.access_token,
+          projectId,
+          sessionId,
+          modelName,
+          thoughtSignature,
+        })
+
+        if (response === "pass-through") {
+          debugLog("Non-string body detected, passing through with auth headers")
+          const headersWithAuth = {
+            ...init.headers,
+            Authorization: `Bearer ${cachedTokens!.access_token}`,
+          }
+          return fetch(url, { ...init, headers: headersWithAuth })
+        }
+
+        if (response === "needs-refresh") {
+          if (hasRefreshedFor401) {
+            debugLog("[401] Already refreshed once, returning unauthorized error")
+            return new Response(
+              JSON.stringify({
+                error: {
+                  message: "Authentication failed after token refresh",
+                  type: "unauthorized",
+                  code: "token_refresh_failed",
+                },
+              }),
+              {
+                status: 401,
+                statusText: "Unauthorized",
+                headers: { "Content-Type": "application/json" },
+              }
+            )
+          }
+
+          debugLog("[401] Refreshing token and retrying...")
+          hasRefreshedFor401 = true
+
+          try {
+            const newTokens = await refreshAccessToken(
+              refreshParts.refreshToken,
+              clientId,
+              clientSecret
+            )
+
+            cachedTokens = {
+              type: "antigravity",
+              access_token: newTokens.access_token,
+              refresh_token: newTokens.refresh_token,
+              expires_in: newTokens.expires_in,
+              timestamp: Date.now(),
+            }
+
+            clearProjectContextCache()
+
+            const formattedRefresh = formatTokenForStorage(
+              newTokens.refresh_token,
+              refreshParts.projectId || "",
+              refreshParts.managedProjectId
+            )
+
+            await client.set(providerId, {
+              access: newTokens.access_token,
+              refresh: formattedRefresh,
+              expires: Date.now() + newTokens.expires_in * 1000,
+            })
+
+            debugLog("[401] Token refreshed, retrying request...")
+            return executeWithEndpoints()
+          } catch (refreshError) {
+            debugLog(`[401] Token refresh failed: ${refreshError instanceof Error ? refreshError.message : "Unknown error"}`)
+            return new Response(
+              JSON.stringify({
+                error: {
+                  message: `Token refresh failed: ${refreshError instanceof Error ? refreshError.message : "Unknown error"}`,
+                  type: "unauthorized",
+                  code: "token_refresh_failed",
+                },
+              }),
+              {
+                status: 401,
+                statusText: "Unauthorized",
+                headers: { "Content-Type": "application/json" },
+              }
+            )
+          }
+        }
+
+        if (response) {
+          debugLog(`Success with endpoint: ${endpoint}`)
+          const transformedResponse = await transformResponseWithThinking(
+            response,
+            modelName || "",
+            fetchInstanceId
+          )
+          return transformedResponse
         }
-        return fetch(url, { ...init, headers: headersWithAuth })
       }
 
-      if (response) {
-        debugLog(`Success with endpoint: ${endpoint}`)
-        const transformedResponse = await transformResponseWithThinking(
-          response,
-          modelName || "",
-          fetchInstanceId
-        )
-        return transformedResponse
-      }
+      const errorMessage = `All Antigravity endpoints failed after ${maxEndpoints} attempts`
+      debugLog(errorMessage)
+
+      return new Response(
+        JSON.stringify({
+          error: {
+            message: errorMessage,
+            type: "endpoint_failure",
+            code: "all_endpoints_failed",
+          },
+        }),
+        {
+          status: 503,
+          statusText: "Service Unavailable",
+          headers: { "Content-Type": "application/json" },
+        }
+      )
     }
 
-    // All endpoints failed
-    const errorMessage = `All Antigravity endpoints failed after ${maxEndpoints} attempts`
-    debugLog(errorMessage)
-
-    // Return error response
-    return new Response(
-      JSON.stringify({
-        error: {
-          message: errorMessage,
-          type: "endpoint_failure",
-          code: "all_endpoints_failed",
-        },
-      }),
-      {
-        status: 503,
-        statusText: "Service Unavailable",
-        headers: { "Content-Type": "application/json" },
-      }
-    )
+    return executeWithEndpoints()
   }
 }
 

src/config/schema.ts

@@ -16,14 +16,27 @@ const AgentPermissionSchema = z.object({
   external_directory: PermissionValue.optional(),
 })
 
-export const AgentNameSchema = z.enum([
+export const BuiltinAgentNameSchema = z.enum([
   "oracle",
   "librarian",
   "explore",
   "frontend-ui-ux-engineer",
   "document-writer",
+  "multimodal-looker",
 ])
 
+export const OverridableAgentNameSchema = z.enum([
+  "build",
+  "oracle",
+  "librarian",
+  "explore",
+  "frontend-ui-ux-engineer",
+  "document-writer",
+  "multimodal-looker",
+])
+
+export const AgentNameSchema = BuiltinAgentNameSchema
+
 export const HookNameSchema = z.enum([
   "todo-continuation-enforcer",
   "context-window-monitor",
@@ -40,6 +53,7 @@ export const HookNameSchema = z.enum([
   "background-notification",
   "auto-update-checker",
   "ultrawork-mode",
+  "agent-usage-reminder",
 ])
 
 export const AgentOverrideConfigSchema = z.object({
@@ -60,11 +74,13 @@ export const AgentOverrideConfigSchema = z.object({
 
 export const AgentOverridesSchema = z
   .object({
+    build: AgentOverrideConfigSchema.optional(),
     oracle: AgentOverrideConfigSchema.optional(),
     librarian: AgentOverrideConfigSchema.optional(),
     explore: AgentOverrideConfigSchema.optional(),
     "frontend-ui-ux-engineer": AgentOverrideConfigSchema.optional(),
     "document-writer": AgentOverrideConfigSchema.optional(),
+    "multimodal-looker": AgentOverrideConfigSchema.optional(),
   })
   .partial()
 
@@ -79,7 +95,7 @@ export const ClaudeCodeConfigSchema = z.object({
 export const OhMyOpenCodeConfigSchema = z.object({
   $schema: z.string().optional(),
   disabled_mcps: z.array(McpNameSchema).optional(),
-  disabled_agents: z.array(AgentNameSchema).optional(),
+  disabled_agents: z.array(BuiltinAgentNameSchema).optional(),
   disabled_hooks: z.array(HookNameSchema).optional(),
   agents: AgentOverridesSchema.optional(),
   claude_code: ClaudeCodeConfigSchema.optional(),

src/hooks/agent-usage-reminder/constants.ts

@@ -0,0 +1,53 @@
+import { join } from "node:path";
+import { xdgData } from "xdg-basedir";
+
+export const OPENCODE_STORAGE = join(xdgData ?? "", "opencode", "storage");
+export const AGENT_USAGE_REMINDER_STORAGE = join(
+  OPENCODE_STORAGE,
+  "agent-usage-reminder",
+);
+
+// All tool names normalized to lowercase for case-insensitive matching
+export const TARGET_TOOLS = new Set([
+  "grep",
+  "safe_grep",
+  "glob",
+  "safe_glob",
+  "webfetch",
+  "context7_resolve-library-id",
+  "context7_get-library-docs",
+  "websearch_exa_web_search_exa",
+  "grep_app_searchgithub",
+]);
+
+export const AGENT_TOOLS = new Set([
+  "task",
+  "call_omo_agent",
+  "background_task",
+]);
+
+export const REMINDER_MESSAGE = `
+[Agent Usage Reminder]
+
+You called a search/fetch tool directly without leveraging specialized agents.
+
+RECOMMENDED: Use background_task with explore/librarian agents for better results:
+
+\`\`\`
+// Parallel exploration - fire multiple agents simultaneously
+background_task(agent="explore", prompt="Find all files matching pattern X")
+background_task(agent="explore", prompt="Search for implementation of Y") 
+background_task(agent="librarian", prompt="Lookup documentation for Z")
+
+// Then continue your work while they run in background
+// System will notify you when each completes
+\`\`\`
+
+WHY:
+- Agents can perform deeper, more thorough searches
+- Background tasks run in parallel, saving time
+- Specialized agents have domain expertise
+- Reduces context window usage in main session
+
+ALWAYS prefer: Multiple parallel background_task calls > Direct tool calls
+`;

src/hooks/agent-usage-reminder/index.ts

@@ -0,0 +1,109 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import {
+  loadAgentUsageState,
+  saveAgentUsageState,
+  clearAgentUsageState,
+} from "./storage";
+import { TARGET_TOOLS, AGENT_TOOLS, REMINDER_MESSAGE } from "./constants";
+import type { AgentUsageState } from "./types";
+
+interface ToolExecuteInput {
+  tool: string;
+  sessionID: string;
+  callID: string;
+}
+
+interface ToolExecuteOutput {
+  title: string;
+  output: string;
+  metadata: unknown;
+}
+
+interface EventInput {
+  event: {
+    type: string;
+    properties?: unknown;
+  };
+}
+
+export function createAgentUsageReminderHook(_ctx: PluginInput) {
+  const sessionStates = new Map<string, AgentUsageState>();
+
+  function getOrCreateState(sessionID: string): AgentUsageState {
+    if (!sessionStates.has(sessionID)) {
+      const persisted = loadAgentUsageState(sessionID);
+      const state: AgentUsageState = persisted ?? {
+        sessionID,
+        agentUsed: false,
+        reminderCount: 0,
+        updatedAt: Date.now(),
+      };
+      sessionStates.set(sessionID, state);
+    }
+    return sessionStates.get(sessionID)!;
+  }
+
+  function markAgentUsed(sessionID: string): void {
+    const state = getOrCreateState(sessionID);
+    state.agentUsed = true;
+    state.updatedAt = Date.now();
+    saveAgentUsageState(state);
+  }
+
+  function resetState(sessionID: string): void {
+    sessionStates.delete(sessionID);
+    clearAgentUsageState(sessionID);
+  }
+
+  const toolExecuteAfter = async (
+    input: ToolExecuteInput,
+    output: ToolExecuteOutput,
+  ) => {
+    const { tool, sessionID } = input;
+    const toolLower = tool.toLowerCase();
+
+    if (AGENT_TOOLS.has(toolLower)) {
+      markAgentUsed(sessionID);
+      return;
+    }
+
+    if (!TARGET_TOOLS.has(toolLower)) {
+      return;
+    }
+
+    const state = getOrCreateState(sessionID);
+
+    if (state.agentUsed) {
+      return;
+    }
+
+    output.output += REMINDER_MESSAGE;
+    state.reminderCount++;
+    state.updatedAt = Date.now();
+    saveAgentUsageState(state);
+  };
+
+  const eventHandler = async ({ event }: EventInput) => {
+    const props = event.properties as Record<string, unknown> | undefined;
+
+    if (event.type === "session.deleted") {
+      const sessionInfo = props?.info as { id?: string } | undefined;
+      if (sessionInfo?.id) {
+        resetState(sessionInfo.id);
+      }
+    }
+
+    if (event.type === "session.compacted") {
+      const sessionID = (props?.sessionID ??
+        (props?.info as { id?: string } | undefined)?.id) as string | undefined;
+      if (sessionID) {
+        resetState(sessionID);
+      }
+    }
+  };
+
+  return {
+    "tool.execute.after": toolExecuteAfter,
+    event: eventHandler,
+  };
+}

src/hooks/agent-usage-reminder/storage.ts

@@ -0,0 +1,42 @@
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  writeFileSync,
+  unlinkSync,
+} from "node:fs";
+import { join } from "node:path";
+import { AGENT_USAGE_REMINDER_STORAGE } from "./constants";
+import type { AgentUsageState } from "./types";
+
+function getStoragePath(sessionID: string): string {
+  return join(AGENT_USAGE_REMINDER_STORAGE, `${sessionID}.json`);
+}
+
+export function loadAgentUsageState(sessionID: string): AgentUsageState | null {
+  const filePath = getStoragePath(sessionID);
+  if (!existsSync(filePath)) return null;
+
+  try {
+    const content = readFileSync(filePath, "utf-8");
+    return JSON.parse(content) as AgentUsageState;
+  } catch {
+    return null;
+  }
+}
+
+export function saveAgentUsageState(state: AgentUsageState): void {
+  if (!existsSync(AGENT_USAGE_REMINDER_STORAGE)) {
+    mkdirSync(AGENT_USAGE_REMINDER_STORAGE, { recursive: true });
+  }
+
+  const filePath = getStoragePath(state.sessionID);
+  writeFileSync(filePath, JSON.stringify(state, null, 2));
+}
+
+export function clearAgentUsageState(sessionID: string): void {
+  const filePath = getStoragePath(sessionID);
+  if (existsSync(filePath)) {
+    unlinkSync(filePath);
+  }
+}

src/hooks/agent-usage-reminder/types.ts

@@ -0,0 +1,6 @@
+export interface AgentUsageState {
+  sessionID: string;
+  agentUsed: boolean;
+  reminderCount: number;
+  updatedAt: number;
+}

src/hooks/index.ts

@@ -14,3 +14,4 @@ export { createRulesInjectorHook } from "./rules-injector";
 export { createBackgroundNotificationHook } from "./background-notification"
 export { createAutoUpdateCheckerHook } from "./auto-update-checker";
 export { createUltraworkModeHook } from "./ultrawork-mode";
+export { createAgentUsageReminderHook } from "./agent-usage-reminder";

src/index.ts

@@ -1,5 +1,5 @@
 import type { Plugin } from "@opencode-ai/plugin";
-import { createBuiltinAgents } from "./agents";
+import { createBuiltinAgents, BUILD_AGENT_PROMPT_EXTENSION } from "./agents";
 import {
   createTodoContinuationEnforcer,
   createContextWindowMonitorHook,
@@ -17,6 +17,7 @@ import {
   createBackgroundNotificationHook,
   createAutoUpdateCheckerHook,
   createUltraworkModeHook,
+  createAgentUsageReminderHook,
 } from "./hooks";
 import { createGoogleAntigravityAuthPlugin } from "./auth/antigravity";
 import {
@@ -207,6 +208,9 @@ const OhMyOpenCodePlugin: Plugin = async (ctx) => {
   const ultraworkMode = isHookEnabled("ultrawork-mode")
     ? createUltraworkModeHook()
     : null;
+  const agentUsageReminder = isHookEnabled("agent-usage-reminder")
+    ? createAgentUsageReminderHook(ctx)
+    : null;
 
   updateTerminalTitle({ sessionId: "main" });
 
@@ -254,6 +258,20 @@ const OhMyOpenCodePlugin: Plugin = async (ctx) => {
         ...projectAgents,
         ...config.agent,
       };
+
+      // Inject orchestration prompt to all non-subagent agents
+      // Subagents are delegated TO, so they don't need orchestration guidance
+      for (const [agentName, agentConfig] of Object.entries(config.agent ?? {})) {
+        if (agentConfig && agentConfig.mode !== "subagent") {
+          const existingPrompt = agentConfig.prompt || "";
+          const userOverride = pluginConfig.agents?.[agentName as keyof typeof pluginConfig.agents]?.prompt || "";
+          config.agent[agentName] = {
+            ...agentConfig,
+            prompt: existingPrompt + BUILD_AGENT_PROMPT_EXTENSION + userOverride,
+          };
+        }
+      }
+
       config.tools = {
         ...config.tools,
       };
@@ -320,6 +338,7 @@ const OhMyOpenCodePlugin: Plugin = async (ctx) => {
       await thinkMode?.event(input);
       await anthropicAutoCompact?.event(input);
       await ultraworkMode?.event(input);
+      await agentUsageReminder?.event(input);
 
       const { event } = input;
       const props = event.properties as Record<string, unknown> | undefined;
@@ -439,6 +458,7 @@ const OhMyOpenCodePlugin: Plugin = async (ctx) => {
       await directoryReadmeInjector?.["tool.execute.after"](input, output);
       await rulesInjector?.["tool.execute.after"](input, output);
       await emptyTaskResponseDetector?.["tool.execute.after"](input, output);
+      await agentUsageReminder?.["tool.execute.after"](input, output);
 
       if (input.sessionID === getMainSessionID()) {
         updateTerminalTitle({

src/mcp/grep-app.ts

@@ -0,0 +1,5 @@
+export const grep_app = {
+  type: "remote" as const,
+  url: "https://mcp.grep.app",
+  enabled: true,
+}

src/mcp/index.ts

@@ -1,5 +1,6 @@
 import { websearch_exa } from "./websearch-exa"
 import { context7 } from "./context7"
+import { grep_app } from "./grep-app"
 import type { McpName } from "./types"
 
 export { McpNameSchema, type McpName } from "./types"
@@ -7,6 +8,7 @@ export { McpNameSchema, type McpName } from "./types"
 const allBuiltinMcps: Record<McpName, { type: "remote"; url: string; enabled: boolean }> = {
   websearch_exa,
   context7,
+  grep_app,
 }
 
 export function createBuiltinMcps(disabledMcps: McpName[] = []) {

src/mcp/types.ts

@@ -1,5 +1,5 @@
 import { z } from "zod"
 
-export const McpNameSchema = z.enum(["websearch_exa", "context7"])
+export const McpNameSchema = z.enum(["websearch_exa", "context7", "grep_app"])
 
 export type McpName = z.infer<typeof McpNameSchema>

src/tools/background-task/tools.ts

@@ -72,8 +72,8 @@ function formatTaskStatus(task: BackgroundTask): string {
   const promptPreview = truncateText(task.prompt, 500)
   
   let progressSection = ""
-  if (task.progress) {
-    progressSection = `\nTool calls: ${task.progress.toolCalls}\nLast tool: ${task.progress.lastTool ?? "N/A"}`
+  if (task.progress?.lastTool) {
+    progressSection = `\n| Last tool | ${task.progress.lastTool} |`
   }
 
   let lastMessageSection = ""
@@ -91,6 +91,17 @@ ${truncated}
 \`\`\``
   }
 
+  let statusNote = ""
+  if (task.status === "running") {
+    statusNote = `
+
+> **Note**: No need to wait explicitly - the system will notify you when this task completes.`
+  } else if (task.status === "error") {
+    statusNote = `
+
+> **Failed**: The task encountered an error. Check the last message for details.`
+  }
+
   return `# Task Status
 
 | Field | Value |
@@ -101,7 +112,7 @@ ${truncated}
 | Status | **${task.status}** |
 | Duration | ${duration} |
 | Session ID | \`${task.sessionID}\` |${progressSection}
-
+${statusNote}
 ## Original Prompt
 
 \`\`\`