GitHub - code-yeongyu/oh-my-opencode: The Best Agent Harness. Meet Sisyphus: The Batteries-Included Agent that codes like you.

oh-my-opencode는 Sisyphus라는 이름의 에이전트(agent)를 핵심으로 하는 OpenCode 기반의 에이전트 하네스(harness)로, LLM 에이전트의 코딩 생산성과 효율성을 극대화하는 것을 목표로 합니다. 개발자가 IDE에서 얻는 이점을 에이전트에게도 제공하여, 복잡한 태스크를 인간과 유사하게 처리하도록 돕습니다.

핵심 방법론 및 기술:

에이전트 오케스트레이션 및 전문화된 에이전트(Agents):

oh-my-opencode는 중앙 Sisyphus 에이전트(기본적으로 anthropic/claude-opus-4.5 사용)가 복잡한 태스크를 계획하고, 위임하며, 실행하는 에이전트 오케스트레이션(orchestration) 모델을 채택합니다. 이를 위해 다음과 같은 전문화된 서브 에이전트(sub-agents)들을 활용합니다:

• Oracle (GPT-5.2): 아키텍처 설계, 코드 리뷰, 전략 수립.

• Librarian (GLM-4.7 Free): 멀티-레포 분석, 문서 조회, 구현 예시 탐색.

• Explore (Grok Code, Gemini 3 Flash, Claude Haiku 4.5): 빠른 코드베이스 탐색 및 패턴 매칭.

• Frontend UI/UX Engineer (Gemini 3 Pro Preview): 프런트엔드 개발.

• Document Writer (Gemini 3 Flash): 기술 문서 작성.

• Multimodal Looker (Gemini 3 Flash): 이미지, PDF, 다이어그램 등 멀티모달 콘텐츠 분석.

이러한 서브 에이전트들은 메인 에이전트에 의해 자동 호출되거나, 사용자가 명시적으로 @oracle 등과 같이 호출할 수 있습니다. 각 에이전트의 모델, 프롬프트, 권한 등은 oh-my-opencode.json을 통해 커스터마이징 가능합니다.

백그라운드 에이전트 및 비동기 실행(Background Agents):

에이전트가 유휴 상태로 있지 않도록 백그라운드 태스크로 서브 에이전트를 병렬적으로 실행하는 기능을 제공합니다. 이를 통해 메인 에이전트가 다른 작업을 수행하는 동안, 예를 들어 GPT가 디버깅하고 Claude가 문제의 근본 원인을 찾는 동시에 Gemini가 프런트엔드를 작성하고 Claude가 백엔드를 처리하는 것과 같은 복잡한 병렬 워크플로우가 가능합니다. 메인 에이전트는 백그라운드 태스크 완료 시 알림을 받거나 필요에 따라 결과를 기다릴 수 있습니다. call_omo_agent 툴의 run_in_background 파라미터를 통해 비동기 실행을 제어하며, sisyphus_task 툴을 통해 카테고리 기반 태스크 위임을 수행합니다.

에이전트를 위한 향상된 개발 도구(LSP & AST-Grep):

LLM 에이전트에게 인간 개발자가 IDE에서 사용하는 것과 유사한 강력한 도구들을 제공하여 코드 분석 및 조작 능력을 강화합니다.

• LSP (Language Server Protocol) 지원: lsp_hover (타입 정보, 문서, 시그니처), lsp_goto_definition (심볼 정의로 이동), lsp_find_references (모든 사용처 찾기), lsp_document_symbols (파일 심볼 개요), lsp_workspace_symbols (프로젝트 전체 심볼 검색), lsp_diagnostics (빌드 전 에러/경고), lsp_prepare_rename (리네임 유효성 검사), lsp_rename (리네임), lsp_code_actions (빠른 수정/리팩토링) 등의 기능을 통해 정확하고 결정론적인 코드 리팩토링 및 분석이 가능합니다.

• AST-Grep 지원: ast_grep_search (AST 기반 코드 패턴 검색) 및 ast_grep_replace (AST 기반 코드 교체) 툴을 통해 25개 언어에 걸쳐 구문 트리를 인식하는 고급 코드 조작이 가능합니다. 이는 단순히 텍스트를 검색/교체하는 것을 넘어 코드의 구조를 이해하고 변경하는 데 필수적입니다.

효율적인 컨텍스트 관리(Context is All You Need):

LLM의 컨텍스트 윈도우(context window) 한계를 극복하고 관련 정보를 효율적으로 제공하기 위한 다양한 메커니즘을 사용합니다:

• Directory AGENTS.md / README.md Injector: 에이전트가 파일을 읽을 때, 해당 파일의 디렉토리부터 프로젝트 루트까지의 모든 AGENTS.md 및 README.md 파일을 자동으로 주입하여 계층적 컨텍스트를 제공합니다.

• Conditional Rules Injector: .claude/rules/ 디렉토리의 규칙 파일에서 조건(globs)이 일치할 때 해당 규칙을 주입하여 특정 파일에 대한 컨텍스트를 동적으로 제공합니다.

• Online Context (MCPs): Exa AI 기반의 websearch, Context7의 공식 문서 조회, Grep.app의 GitHub 코드 검색 등 빌트인 MCP(Managed Control Plane)를 통해 온라인 리소스로부터 실시간 정보를 가져와 컨텍스트를 확장합니다.

• look_at 툴: 대용량 파일 전체를 컨텍스트에 로드하는 대신, 다른 에이전트를 활용하여 파일에서 필요한 정보만 추출하도록 하여 토큰 사용량을 최적화합니다.

지속적인 실행 및 태스크 완료 보장:

• ultrawork / ulw 키워드: 사용자가 프롬프트에 ultrawork 또는 ulw를 포함하면, 병렬 에이전트 오케스트레이션, 백그라운드 태스크, 심층 탐색, 그리고 태스크 완료 시까지의 끊임없는 실행과 같은 모든 고급 기능이 자동으로 활성화됩니다.

• Todo Continuation Enforcer: 에이전트가 TODO 리스트를 완료하기 전에는 작업을 중단하지 않도록 강제하여, LLM이 작업을 중간에 포기하는 고질적인 문제를 해결합니다.

• Ralph Loop: Anthropic의 Ralph Wiggum 플러그인에서 영감을 받아, DONE 시그널이 감지되거나 최대 반복 횟수에 도달할 때까지 에이전트가 태스크를 지속적으로 실행하는 자체-참조적 개발 루프를 제공합니다.

Claude Code 호환성 및 확장성:

기존 Claude Code 사용자를 위해 호환성 레이어를 제공하여 기존 설정을 그대로 사용할 수 있도록 합니다. hooks (PreToolUse, PostToolUse, UserPromptSubmit, Stop), Command Loader, Skill Loader, Agent Loader, MCP Loader 등을 통해 강력한 확장 및 커스터마이징이 가능합니다. 또한 opencode-antigravity-auth 및 opencode-openai-codex-auth 플러그인 통합을 통해 Google Gemini 및 OpenAI 모델을 포함한 다양한 LLM 공급자 인증 및 모델 오버라이딩을 지원합니다.

요약하자면, oh-my-opencode는 전문화된 에이전트들의 오케스트레이션, 강력한 개발 도구(LSP, AST-Grep)의 에이전트 적용, 효율적인 컨텍스트 관리, 그리고 태스크 완료를 위한 지속적인 실행 메커니즘을 통해 LLM 에이전트의 코드 작성 능력과 생산성을 혁신하는 에이전트 하네스입니다.