🔷 04. Oh-My-OpenCode 개요

Oh-My-OpenCode를 처음 접하는 사람을 위해, 정체(무엇인지) → 설치 이유(왜 쓰는지) → 체감 이점(뭐가 좋아지는지) 순서로 설명한 입문 문서입니다.

Oh-My-OpenCode가 뭔가요?

OpenCode 자체를 대체하는 도구가 아니라, OpenCode 위에 얹는 운영 레이어입니다.

• OpenCode: 기본 코딩 에이전트 실행기
• Oh-My-OpenCode: 에이전트 역할 분리, 플래닝/실행 워크플로우, 스킬/훅/커맨드 세트를 한 번에 붙여주는 확장팩

즉, “기본 에이전트 1명”에서 “역할이 나뉜 팀 운영”으로 올려주는 세팅이라고 보면 됩니다.

flowchart LR
A[OpenCode 기본 실행] --> B[Oh-My-OpenCode 설치]
B --> C[계획: Prometheus]
B --> D[실행: Atlas]
B --> E[빠른 실행: ulw]
C --> F[안정적인 반복 작업]
D --> F
E --> F

왜 설치하나요?

1) 반복 작업을 덜 수 있음

매번 “어떻게 진행할지”를 길게 설명하지 않아도, /start-work, ulw 같은 패턴으로 빠르게 시작할 수 있습니다.

2) 복잡한 작업에서 품질이 안정됨

Prometheus(계획)와 Atlas(실행)를 분리해, 한 세션에서 계획과 실행이 섞여 생기는 혼선을 줄입니다.

3) 모델/공급자 운영이 쉬워짐

설치 시 구독 상태를 반영하고, 런타임에서 모델 fallback 체인을 활용해 작업 중단 리스크를 낮춥니다.

4) 팀 표준화가 쉬움

카테고리/스킬/훅을 설정 파일로 공유해 팀 전체 작업 품질을 맞추기 쉽습니다.

뭐가 좋아지나요? (체감 포인트)

• 전: 매번 수동으로 지시문을 길게 작성

• 후: ulw, @plan, /start-work 같은 고정 루틴으로 빠르게 실행

• 전: 큰 작업에서 중간에 방향이 자주 바뀜

• 후: 계획 문서(.sisyphus/plans) 기반으로 재개/추적 가능

• 전: 새 프로젝트마다 세팅이 들쭉날쭉

• 후: oh-my-opencode.json로 일관된 기본값 유지

입문 추천 순서 (혼란 방지)

1. 04. 개요
2. 05. 설치
3. 07. CLI 가이드
4. 09. 오케스트레이션 실전
5. 14. Ultrawork 매니페스토

빠르게 실행 (복붙)

opencode --version
bunx oh-my-opencode install
@plan "결제 모듈 리팩터링 계획 세워줘"
/start-work
ulw add authentication to my Next.js app
opencode models

단계별 적용

1) 설치 전 역할 이해

• 설명: Oh-My-OpenCode는 OpenCode를 대체하는 게 아니라 팀형 워크플로우를 붙이는 확장이라는 점을 먼저 이해합니다.
• 실행 예시: opencode --version

2) 설치 완료

• 설명: install을 실행해 플러그인/커맨드/기본 구성요소를 등록합니다.
• 실행 예시: bunx oh-my-opencode install

3) 정밀 작업 시작

• 설명: 중요 작업은 @plan으로 인터뷰 기반 계획을 만든 뒤 /start-work로 실행합니다.
• 실행 예시: @plan "결제 모듈 리팩터링 계획 세워줘"

4) 빠른 작업 시작

• 설명: 짧은 수정은 ulw로 바로 실행해 탐색+구현+검증 루프를 돌립니다.
• 실행 예시: ulw add authentication to my Next.js app

5) 모델 가용성 확인

• 설명: 실제 사용 가능한 모델 목록과 공급자 상태를 확인합니다.
• 실행 예시: opencode models

부록) 원문 코드 스니펫 (검수용, 초보자는 건너뛰기)

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
  "agents": {
    // Override specific agents only - rest use fallback chain
    "atlas": { "model": "anthropic/claude-sonnet-4-5", "variant": "max" },
    "librarian": { "model": "zai-coding-plan/glm-4.7" },
    "explore": { "model": "opencode/gpt-5-nano" },
    "multimodal-looker": { "model": "zai-coding-plan/glm-4.6v" }
  },
  "categories": {
    // Override categories for cost optimization
    "quick": { "model": "opencode/gpt-5-nano" },
    "unspecified-low": { "model": "zai-coding-plan/glm-4.7" }
  },
  "experimental": {
    "aggressive_truncation": true
  }
}

마무리 체크

• “왜 설치하는지”를 한 문장으로 설명할 수 있다.
• ulw와 @plan→/start-work의 차이를 설명할 수 있다.
• 다음 문서(05 설치)로 넘어갈 준비가 되었다.

---

출처

• 원문(로컬): oh-my-opencode/docs/guide/overview.md
• 원문(GitHub): https://github.com/code-yeongyu/oh-my-opencode/blob/dev/docs/guide/overview.md