[!NOTE] 🚀 첫 Codex 버전 출시: omo 이제 Codex CLI에서 사용 가능합니다

더 이상 복잡한 JSON 설정은 필요 없습니다. 그냥 실행하세요:

bashCopy

npx lazycodex-ai install

당신의 Codex가 명확하게 코딩하고, 내장 computer-use QA로 작업을 완수합니다. 자세한 내용은 lazycodex.ai에서 확인하세요.

[!NOTE] 멀티 하니스 에이전트 OS 리팩토링 진행 중

OpenCode, Codex, Pi 등 여러 에이전트 하니스를 지원하기 위해 코드베이스를 재구성하고 있습니다. 기여에 관심이 있다면 먼저 ROADMAP을 확인해 주세요. ROADMAP 관련 PR에는 ROADMAP 라벨을 붙여 주세요.

[!TIP] Building in Public

메인테이너는 oh-my-openagent를 실시간으로 개발하고 유지보수합니다. OpenClaw를 크게 커스터마이즈한 포크 위에서 동작하는 AI 어시스턴트 Jobdori와 함께요. 모든 기능, 모든 수정, 모든 이슈 트리아지 — 전부 Discord에서 라이브로.

→ #building-in-public 채널에서 지켜보기

[!NOTE]

OmO는 위의 Jobdori에 의해 메인테이닝되고 있습니다. 당신의 Jobdori, Dori를 만나세요. 대기 명단은 여기에서 받습니다.

[!TIP] 함께해요!

	기여자와 oh-my-openagent 사용자들을 만나려면 Discord 커뮤니티로 오세요.
	원래 제 X 계정에서 oh-my-openagent 업데이트를 올렸는데, 계정이 실수로 정지되어 지금은 @justsisyphus에서 대신 업데이트가 올라옵니다.
	다른 프로젝트도 궁금하다면 GitHub에서 @code-yeongyu를 팔로우하세요.

<a href="https://github.com/code-yeongyu/oh-my-openagent#oh-my-openagent"></a>

이건 oh-my-openagent의 Team Mode 동작 장면입니다. Kimi K2.6과 GPT-5.5로요.

Anthropic은 우리 때문에 OpenCode를 차단했습니다. 진짜입니다. 그들은 당신을 가둬두고 싶어 합니다. Claude Code는 좋은 감옥이지만, 여전히 감옥입니다.

2시간짜리 작업에 200달러를 낼 필요는 없습니다. 미래는 한 명의 승자를 고르는 게 아니라, 모두를 오케스트레이션하는 쪽에 있습니다. 모델은 매달 저렴해지고, 매달 똑똑해집니다. 어떤 벤더도 독점하지 못합니다. 우리는 그런 오픈 마켓을 위해 빌드합니다. 그들의 담장 안 정원이 아니라.

English | 한국어 | 日本語 | 简体中文

리뷰

"Cursor 구독을 해지하게 만들었습니다. 오픈소스 커뮤니티에서 믿기지 않는 일들이 벌어지고 있어요." - Arthur Guiot

"Claude Code가 7일에 하는 일을 사람이 3개월 걸려 한다고 치면, Sisyphus는 1시간 만에 끝냅니다. 태스크가 끝날 때까지 그냥 돌아갑니다. 말 그대로 기강 잡힌 에이전트예요."

• B, 퀀트 리서처

"Oh My Opencode로 하루 만에 eslint 경고 8000개를 날려버렸습니다."

• Jacob Ferrari

"4만 5천 줄짜리 Tauri 앱을 Ohmyopencode와 Ralph Loop로 하룻밤 사이에 SaaS 웹 앱으로 전환했습니다. 'interview me' 프롬프트부터 시작해서 질문들에 대한 평가와 개선 제안을 받았어요. 작업 과정을 지켜보는 것도 즐거웠고, 아침에 일어나니 거의 동작하는 사이트가 나와 있더군요!" - James Hargis

"oh-my-opencode 한 번 써보면 돌아갈 수 없습니다."

• d0t3ch

"뭐가 그렇게 대단한지 정확히 말로는 아직 못 하겠는데, 개발 경험이 완전히 다른 차원으로 넘어갔습니다." - 苔硯:こけすずり

"이번 주말은 open code, oh my opencode, supermemory로 마인크래프트/소울즈류 합성체를 만들고 있습니다." "점심 먹고 산책 다녀오는 동안 크라우치 애니메이션 추가해달라고 시켜놨습니다. [영상]" - MagiMetal

"이걸 코어에 편입시키고 만든 사람 영입하세요. 진심으로요. 진짜, 진짜, 진짜 좋습니다."

• Henning Kilset

"@yeon_gyu_kim 설득할 수 있으면 꼭 뽑으세요. 이 친구 opencode를 혁신했어요."

• mysticaltech

"Oh My OpenCode는 진짜 미쳤습니다" - YouTube - Darren Builds AI

Oh My OpenAgent

Claude Code, Codex, 듣도 보도 못한 OSS 모델들까지 저글링 중이시죠. 워크플로우를 손보고, 에이전트를 디버깅하고.

그 일은 우리가 했습니다. 전부 테스트했고, 실전에 먹힌 것만 남겼습니다.

oh-my-openagent를 설치하세요. ultrawork를 입력하세요. 끝.

설치

사람을 위한 설치

이 프롬프트를 당신의 LLM 에이전트(Claude Code, AmpCode, Cursor 등)에 붙여넣으세요:

Install and configure oh-my-openagent by following the instructions here:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

아니면 설치 가이드를 직접 읽으셔도 됩니다. 다만 진심으로, 에이전트한테 시키세요. 사람은 설정 파일을 오타로 망칩니다.

LLM 에이전트를 위한 설치

설치 가이드를 받아와서 그대로 따르세요:

curl -s https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

참고: 배포된 npm 패키지와 CLI 바이너리 이름은 여전히 oh-my-opencode입니다(전환 기간 동안 oh-my-openagent로도 함께 배포됩니다). opencode.json 안에서는 호환성 레이어가 이제 oh-my-openagent 플러그인 엔트리를 우선합니다. 기존 oh-my-opencode 엔트리도 경고와 함께 여전히 로드됩니다. 플러그인 설정 파일도 여전히 oh-my-opencode.json이나 oh-my-opencode.jsonc를 많이 씁니다. 전환 기간 동안에는 기존 이름과 새 이름 둘 다 인식됩니다.

익명 텔레메트리는 활성 설치 수(DAU/WAU/MAU) 집계를 위해 기본적으로 활성화되어 있습니다. 머신당 UTC 하루에 최대 1회만 이벤트가 전송되며, 해시된 설치 식별자를 사용하고 원시 호스트명은 절대 사용하지 않으며 PostHog person profile은 생성되지 않습니다. OMO_SEND_ANONYMOUS_TELEMETRY=0 또는 OMO_DISABLE_POSTHOG=1로 비활성화할 수 있습니다. 개인정보처리방침과 서비스 이용약관을 참조하세요.

Ultimate vs Light: oh-my-openagent는 같은 제품의 두 에디션으로 출시됩니다. Ultimate 에디션(bunx oh-my-openagent install 또는 --platform=opencode, 기본값)은 OpenCode 위에서 풀 기능 — 11 agent, 54+ hook, Team Mode, 모든 MCP, 슬래시 명령, IntentGate 모드 — 을 제공합니다. Light 에디션(bunx oh-my-openagent install --platform=codex)은 OpenAI Codex CLI의 플러그인 시스템에 깔끔히 포팅되는 5개 컴포넌트(rules, comment-checker, lsp, ultrawork, ulw-loop)만 제공합니다. bunx lazycodex-ai install은 --platform=codex의 단축 별칭입니다. 둘 다 설치하려면 --platform=both. Codex 전용 텔레메트리는 OMO_CODEX_DISABLE_POSTHOG=1 또는 OMO_CODEX_SEND_ANONYMOUS_TELEMETRY=0으로 비활성화할 수 있습니다.

이 README 건너뛰기

이제 문서 읽는 시대는 지났습니다. 그냥 아래를 에이전트에 붙여넣으세요:

Read this and tell me why it's not just another boilerplate: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/README.md

하이라이트

🪄 ultrawork

아직도 이 문서를 읽고 있다고요? 대단하네요.

설치하세요. ultrawork(또는 ulw)를 입력하세요. 끝.

아래 나오는 모든 기능, 모든 최적화는 몰라도 됩니다. 그냥 작동합니다.

아래 구독 조합만으로도 ultrawork는 잘 돌아갑니다(이 프로젝트와는 무관한 개인 추천입니다):

• ChatGPT 구독 ($20)
• Kimi Code 구독 ($19)
• GLM Coding 요금제 ($10)
• 종량제(pay-per-token) 대상자라면 kimi와 gemini 모델을 써도 비용이 별로 안 나옵니다.

Editions legend. Ultimate = OpenCode 전용 (bunx oh-my-openagent install). Light = Codex CLI 전용 (bunx oh-my-openagent install --platform=codex). Both = 두 에디션 모두 제공, 종종 내부 구현은 약간 다름.

Discipline Agents

Sisyphus (claude-opus-4-7 / kimi-k2.6 / glm-5.1)는 메인 오케스트레이터입니다. 계획을 세우고, 전문가에게 위임하고, 공격적인 병렬 실행으로 작업을 끝까지 밀어붙입니다. 중간에 멈추지 않습니다.

Hephaestus (gpt-5.5)는 자율적으로 깊게 파는 작업자입니다. 레시피가 아니라 목표를 주세요. 코드베이스를 탐색하고, 패턴을 조사하고, 손을 잡아주지 않아도 엔드투엔드로 실행합니다. The Legitimate Craftsman.

Prometheus (claude-opus-4-7 / kimi-k2.6 / glm-5.1)는 전략 플래너입니다. 인터뷰 모드: 질문으로 스코프를 파악하고, 코드에 손대기 전에 상세한 계획을 만듭니다.

모든 에이전트는 자기 모델의 강점에 맞춰 튜닝되어 있습니다. 수동으로 모델을 돌려가며 쓸 필요가 없습니다. 더 알아보기 →

Anthropic은 우리 때문에 OpenCode를 차단했습니다. 그래서 Hephaestus에게 "The Legitimate Craftsman"이라는 별명이 붙었습니다. 의도된 아이러니입니다.

Opus에서 가장 잘 돌지만, Kimi K2.6 + GPT-5.5 조합만으로도 이미 바닐라 Claude Code를 이깁니다. 별도 설정 없이요.

Team Mode (v4.0)

에이전트 한 명도 빠릅니다. 조율된 팀은 압도적입니다.

Team Mode는 oh-my-openagent를 "서브에이전트를 가진 한 명의 에이전트"에서 진짜 멀티 에이전트 시스템으로 바꿉니다. 리드 에이전트가 카테고리별 전문화된 멤버 팀을 지휘하며, 모두 병렬로 동작하고 전용 도구(team_create, team_send_message, team_task_create, team_status, ...)로 통신합니다. tmux 레이아웃의 focus + grid 윈도우에서 모든 멤버의 작업을 동시에 지켜보세요.

// .opencode/oh-my-openagent.jsonc
{
  "team_mode": {
    "enabled": true,
    "max_parallel_members": 4,
    "tmux_visualization": true
  }
}

opencode를 재시작하면 team_* 도구 패밀리가 활성화됩니다. 이미 두 개의 스킬이 그 위에 올라가 있습니다:

• hyperplan — 5명의 적대적 에이전트가 코드 한 줄 작성되기 전에 직교 각도에서 당신의 계획을 갈가리 분해합니다.
• security-research — 3명의 취약점 헌터 + 2명의 PoC 엔지니어가 코드베이스를 병렬로 감사합니다. 심각도는 실제 익스플로잇 가능성으로 보정됩니다.

기본은 OFF. 원할 때 켜세요. Team Mode 가이드 전체 →

Agent Orchestration

Sisyphus가 서브에이전트에 위임할 때는 모델을 직접 고르지 않습니다. 카테고리를 고릅니다. 카테고리는 자동으로 적합한 모델에 매핑됩니다:

에이전트는 필요한 작업 종류만 말하고, 하네스가 적합한 모델을 고릅니다. ultrabrain은 이제 기본으로 GPT-5.5 xhigh로 라우팅됩니다. 당신이 건드릴 건 없습니다.

Claude Code 호환성

Claude Code 세팅을 손봐두셨죠. 잘하셨습니다.

hook, command, skill, MCP, plugin 전부 그대로 여기서 동작합니다. 플러그인까지 포함한 완전 호환입니다.

당신의 에이전트를 위한 월드클래스 도구

LSP, AST-Grep, Tmux, MCP — 대충 붙여놓은 게 아니라 실제로 통합되어 있습니다.

• LSP: lsp_rename, lsp_goto_definition, lsp_find_references, lsp_diagnostics. 모든 에이전트에게 IDE 수준 정밀도를.
• AST-Grep: 25개 언어에 걸친 패턴 기반 코드 검색·리라이트.
• Tmux: 풀 인터랙티브 터미널. REPL, 디버거, TUI 앱. 에이전트가 세션 안에 그대로 머뭅니다.
• MCP: 웹 검색, 공식 문서, GitHub 코드 검색. 기본 탑재.

Skill-Embedded MCPs

MCP 서버는 컨텍스트 예산을 갉아먹습니다. 우리가 고쳤습니다.

스킬이 자기만의 MCP 서버를 데리고 다닙니다. 필요할 때 올라오고, 태스크 스코프 안에서만 살아 있다가, 끝나면 사라집니다. 컨텍스트 윈도우가 깔끔하게 유지됩니다.

더 잘 코딩합니다. Hash-Anchored Edits

하네스 문제는 실존합니다. 대부분의 에이전트 실패는 모델 잘못이 아니라 편집 도구 탓입니다.

"이 도구들 중 어느 것도 모델이 수정하려는 라인에 대한 안정적이고 검증 가능한 식별자를 주지 않는다... 모델이 이미 본 내용을 재현해내길 바라는 방식에 의존한다. 재현하지 못할 때 — 그리고 자주 못한다 — 사용자는 모델을 탓한다."

• Can Bölük, The Harness Problem

oh-my-pi에서 영감을 받아 Hashline을 만들었습니다. 에이전트가 읽는 모든 라인은 콘텐츠 해시가 붙어 돌아옵니다:

11#VK| function hello() {
22#XJ|   return "world";
33#MB| }

에이전트는 이 태그를 참조해 편집합니다. 마지막 읽은 이후 파일이 바뀌었다면 해시가 맞지 않고, 손상 전에 편집이 거부됩니다. 공백 재현 필요 없음. 낡은 라인 에러 없음.

Grok Code Fast 1: 6.7% → 68.3% 성공률. 편집 도구만 바꿔서요.

깊은 초기화. /init-deep

/init-deep을 실행하세요. 계층형 AGENTS.md 파일을 생성합니다:

project/
├── AGENTS.md              ← 프로젝트 전체 컨텍스트
├── src/
│   ├── AGENTS.md          ← src 전용 컨텍스트
│   └── components/
│       └── AGENTS.md      ← 컴포넌트 전용 컨텍스트

에이전트는 관련 컨텍스트를 알아서 읽습니다. 수동 관리 0.

플래닝. Prometheus

복잡한 작업인가요? 프롬프트 쓰고 기도하지 마세요.

/start-work가 Prometheus를 호출합니다. 진짜 엔지니어처럼 인터뷰를 진행하고, 스코프와 모호한 부분을 짚어내고, 코드에 손대기 전에 검증된 계획을 세웁니다. 에이전트는 뭘 만들지 알고 나서야 시작합니다.

Skills

Skill은 단순 프롬프트가 아닙니다. 각 스킬은:

• 도메인 튜닝된 시스템 지시를 갖고 있고,
• MCP 서버를 필요할 때 함께 데려오며,
• 권한 범위가 지정되어 에이전트가 선을 넘지 않습니다.

빌트인: playwright(브라우저 자동화), git-master(atomic 커밋, rebase 수술), frontend-ui-ux(디자인 우선 UI).

직접 추가하려면 .opencode/skills/*/SKILL.md 또는 ~/.config/opencode/skills/*/SKILL.md 아래에 넣으세요.

전체 기능을 보고 싶다면? **Features Documentation**에서 에이전트, hook, 도구, MCP 등 모든 것을 상세히 확인할 수 있습니다.

oh-my-openagent가 처음이라면? 뭘 갖게 되는지는 **Overview**를, 에이전트들이 어떻게 협업하는지는 **Orchestration Guide**를 참고하세요.

제거

oh-my-openagent를 제거하려면:

1. OpenCode 설정에서 플러��인을 제거합니다

   ~/.config/opencode/opencode.json(또는 opencode.jsonc)을 열어 plugin 배열에서 "oh-my-openagent" 또는 기존 "oh-my-opencode" 항목을 삭제합니다:

   bashCopy

   # jq 사용
   jq '.plugin = [.plugin[] | select(. != "oh-my-openagent" and . != "oh-my-opencode")]' \
       ~/.config/opencode/opencode.json > /tmp/oc.json && \
       mv /tmp/oc.json ~/.config/opencode/opencode.json
   

2. 설정 파일 제거 (선택 사항)

   bashCopy

   # 호환 기간 동안 인식되는 플러그인 설정 파일 제거
   rm -f ~/.config/opencode/oh-my-openagent.jsonc ~/.config/opencode/oh-my-openagent.json \
         ~/.config/opencode/oh-my-opencode.jsonc ~/.config/opencode/oh-my-opencode.json
   
   # 프로젝트 설정 제거 (있다면)
   rm -f .opencode/oh-my-openagent.jsonc .opencode/oh-my-openagent.json \
         .opencode/oh-my-opencode.jsonc .opencode/oh-my-opencode.json
   

3. 제거 확인

   bashCopy

   opencode --version
   # 더 이상 플러그인이 로드되지 않아야 합니다
   

4. omo-codex (Codex CLI Light 에디션) 제거

   bashCopy

   rm -rf ~/.codex/plugins/cache/sisyphuslabs
   

   그런 다음 ~/.codex/config.toml을 열어 [marketplaces.sisyphuslabs], [plugins."omo@sisyphuslabs"], [hooks.state."omo@sisyphuslabs:..."] 블록들을 삭제하세요.

Features

진작 있었어야 했다고 느낄 기능들입니다. 한 번 쓰면 되돌아갈 수 없습니다.

전체 내용은 Features Documentation 참고.

요약:

• Agents: Sisyphus(메인), Prometheus(플래너), Oracle(아키텍처·디버깅), Librarian(문서·코드 검색), Explore(빠른 코드베이스 grep), Multimodal Looker
• Background Agents: 진짜 개발팀처럼 여러 에이전트를 병렬로 실행
• LSP & AST Tools: 리팩터링, rename, 진단, AST 기반 코드 검색
• Hash-anchored Edit Tool: LINE#ID 참조로 모든 변경 전에 내용을 검증. 수술적 편집, 낡은 라인 에러 0
• Context Injection: AGENTS.md, README.md, 조건부 규칙 자동 주입
• Claude Code Compatibility: 전체 hook 시스템, command, skill, agent, MCP
• Built-in MCPs: websearch(Exa), context7(문서), grep_app(GitHub 검색)
• Session Tools: 세션 히스토리 조회·읽기·검색·분석
• Productivity Features: Ralph Loop, Todo Enforcer, Comment Checker, Think Mode 등
• Doctor Command: 빌트인 진단(bunx oh-my-opencode doctor)으로 플러그인 등록, 설정, 모델, 환경 검증
• Model Fallbacks: fallback_models에 단순 모델 문자열과 per-fallback 객체 설정을 같은 배열에 섞어 쓸 수 있음
• File Prompts: 에이전트 설정에서 file://로 프롬프트를 파일에서 로드
• Session Recovery: 세션 에러, 컨텍스트 윈도우 한계, API 실패에서 자동 복구
• Model Setup: 에이전트-모델 매칭은 설치 가이드에 기본 포함

설정

의견이 분명한 기본값. 꼭 손대야겠다면 조정 가능.

자세한 내용은 Configuration Documentation 참고.

요약:

• 설정 파일 위치: 호환성 레이어는 oh-my-openagent.json[c]와 기존 oh-my-opencode.json[c] 플러그인 설정 파일을 모두 인식합니다. 기존 설치는 아직 기존 이름을 쓰는 경우가 많습니다.
• JSONC 지원: 주석과 trailing comma 지원
• Agents: 어떤 에이전트든 모델, temperature, 프롬프트, 권한을 오버라이드
• Built-in Skills: playwright(브라우저 자동화), git-master(atomic 커밋)
• Sisyphus Agent: Prometheus(플래너), Metis(플랜 컨설턴트)와 함께 도는 메인 오케스트레이터
• Background Tasks: 프로바이더/모델별 동시성 제한 설정
• Categories: 도메인별 태스크 위임(visual, business-logic, 커스텀)
• Hooks: 54개 이상의 라이프사이클 hook (Team Mode 활성화 시 61개), 전부 disabled_hooks로 제어 가능
• MCPs: 빌트인 websearch(Exa), context7(문서), grep_app(GitHub 검색)
• LSP: 리팩터링 도구까지 포함한 풀 LSP 지원
• Experimental: 공격적 truncation, 자동 재개 등

저자의 메모

철학이 궁금하다면? Ultrawork Manifesto를 읽어보세요.

개인 프로젝트에 LLM 토큰값으로 2만 4천 달러를 태웠습니다. 온갖 도구를 다 써봤고, 설정을 죽도록 만졌습니다. 결국 OpenCode가 이겼습니다.

제가 부딪힌 모든 문제의 해법이 이 플러그인에 박혀 있습니다. 설치만 하고 시작하세요.

OpenCode가 Debian/Arch라면, oh-my-openagent는 Ubuntu/Omarchy입니다.

AmpCode와 Claude Code의 영향을 많이 받았습니다. 기능을 옮겨왔고, 많은 경우 개선까지 했습니다. 지금도 만들고 있습니다. 이건 OpenCode입니다.

다른 하네스들은 멀티모델 오케스트레이션을 약속합니다. 우리는 출시합니다. 안정성도. 그리고 실제로 동작하는 기능들도.

저는 이 프로젝트의 가장 집착적인 사용자입니다:

• 어떤 모델이 가장 날카로운 논리를 갖고 있나?
• 누가 디버깅의 신인가?
• 누가 가장 좋은 산문을 쓰나?
• 누가 프론트엔드를 지배하나?
• 누가 백엔드를 소유하나?
• 매일 데일리 드라이빙할 때 가장 빠른 건?
• 경쟁자들은 뭘 출시하고 있나?

이 플러그인은 그 증류액입니다. 가장 좋은 걸 가져가세요. 개선안 있으면 PR 환영입니다.

하네스 선택으로 고뇌하는 건 이제 그만하세요. 제가 리서치하고, 가장 좋은 걸 훔쳐와서, 여기 출시하겠습니다.

오만하게 들리나요? 더 나은 방법이 있으신가요? 기여해주세요. 환영합니다.

언급된 어떤 프로젝트나 모델과도 제휴 관계는 없습니다. 그저 개인적인 실험의 결과입니다.

이 프로젝트의 99%는 OpenCode로 만들어졌습니다. 저는 TypeScript를 사실 잘 모릅니다. 다만 이 문서만큼은 제가 직접 검토하고 대부분 다시 썼습니다.

전문가들이 현업에서 쓰고 있습니다

• Indent
  • Spray(인플루언서 마케팅 솔루션), vovushop(크로스보더 커머스 플랫폼), vreview(AI 커머스 리뷰 마케팅 솔루션) 개발사.
• Google
• Microsoft
• Vercel
• ELESTYLE
  • elepay(멀티 모바일 결제 게이트웨이), OneQR(캐시리스 솔루션용 모바일 앱 SaaS) 개발사.
• Deepgram

훌륭한 hero 이미지를 만들어준 @junhoyeo에게 특별히 감사드립니다.