oh-my-codex(OMX): OpenAI Codex CLI를 위한 워크플로우 레이어 정리

이 글은 oh-my-codex(OMX)가 무엇인지, 왜 필요한지, 그리고 실제로 어떻게 사용하는 도구인지 한 번에 이해할 수 있도록 정리한 글입니다. OMX는 OpenAI Codex CLI 자체를 대체하는 도구가 아니라, Codex를 더 안정적이고 일관되게 쓰기 위한 워크플로우 레이어입니다. Codex를 이미 사용하고 있지만 작업 흐름이 산만하거나 반복되는 과정이 많다고 느낀 분이라면, 이 글을 통해 OMX의 개념과 핵심 가치를 명확히 이해할 수 있을 것입니다.

반응형

---

oh-my-codex(OMX)란 무엇인가

OMX는 OpenAI Codex CLI를 실행 엔진으로 그대로 유지하면서, 그 위에 표준화된 작업 흐름과 역할, 상태 관리 기능을 추가하는 도구입니다.
핵심 철학은 단순합니다.

• Codex는 실제 에이전트 작업을 수행한다
• OMX는 그 작업을 더 잘 시작하고, 더 잘 정리하고, 끝까지 밀어주는 환경을 제공한다

즉, OMX는 새로운 AI가 아니라 Codex를 매일 쓰기 좋게 만드는 운영 레이어입니다.

---

OMX가 필요한 이유

Codex CLI를 직접 사용하다 보면 다음과 같은 문제가 자주 발생합니다.

• 요청이 모호한 상태에서 바로 실행을 시작한다
• 계획 없이 코드를 작성하다가 중간에 방향이 바뀐다
• 여러 작업을 병렬로 처리하기 어렵다
• 이전 결정, 로그, 맥락이 남지 않는다

OMX는 이런 문제를 해결하기 위해 만들어졌습니다.
“생각 → 계획 → 실행”의 흐름을 강제로라도 지키게 만들어, 결과의 일관성과 재현성을 높이는 것이 목적입니다.

---

OMX의 핵심 개념과 구조

Codex는 그대로, 실행 환경만 강화

OMX는 Codex를 감싸는 구조입니다.

• Codex: 실제 모델 호출과 에이전트 실행 담당
• OMX: 역할, 스킬, 워크플로우, 상태 관리 담당

이 구조 덕분에 Codex의 장점은 유지하면서, 운영 측면의 불편함만 해결합니다.

---

표준 워크플로우: OMX의 중심

OMX는 다음 네 가지 키워드를 중심으로 한 표준 작업 흐름을 제공합니다.

1. $deep-interview
   요청이 모호할 때 범위와 요구사항을 먼저 명확히 합니다.
2. $ralplan
   정리된 요구사항을 바탕으로 설계와 구현 계획을 만들고 승인합니다.
3. $ralph
   승인된 계획을 기준으로 하나의 책임자가 끝까지 실행합니다.
4. $team
   여러 역할이 동시에 필요한 경우, 병렬 실행을 관리합니다.

이 흐름 덕분에 “일단 돌려보자” 식의 실행을 줄이고, 계획 기반 실행이 기본값이 됩니다.

---

.omx 디렉터리의 역할

OMX는 모든 상태를 .omx/ 디렉터리에 저장합니다.

• 승인된 계획
• 실행 로그
• 메모리와 맥락 정보
• 현재 실행 모드 상태

이 구조 덕분에 작업이 중단되더라도 다시 이어서 진행할 수 있고,
왜 이런 결정을 내렸는지도 나중에 확인할 수 있습니다.

---

권장 실행 환경과 주의사항

OMX는 기본적으로 macOS 또는 Linux + Codex CLI 환경을 기준으로 설계되었습니다.

• macOS / Linux: 공식 권장 환경
• tmux 사용 시 팀 런타임 안정성 높음
• Native Windows 및 Codex App: 비권장, 일부 기능 불안정

Windows 환경에서는 WSL2 사용이 더 나은 선택으로 안내됩니다.

---

설치 및 기본 사용 흐름

설치

npm install -g @openai/codex oh-my-codex

기본 점검

omx doctor
codex login status
omx exec --skip-git-repo-check -C . "Reply with exactly OMX-EXEC-OK"

이 단계는 “설치가 되었는지”가 아니라,
실제로 Codex가 인증된 상태로 실행 가능한지를 확인하는 과정입니다.

---

추천 실행 방식 예시

OMX의 기본 실행 흐름은 다음과 같습니다.

$deep-interview "clarify the authentication change"
$ralplan "approve the auth plan and review tradeoffs"
$ralph "carry the approved plan to completion"
$team 3:executor "execute the approved plan in parallel"

이 방식은 단순하지만, 작업 품질과 안정성 면에서 큰 차이를 만듭니다.

---

팀 런타임과 고급 기능

• omx team: tmux 기반 병렬 실행 관리
• omx setup / update: 프롬프트, 훅, 설정 자동 관리
• omx hud: 상태 모니터링
• omx explore: 읽기 전용 코드 탐색
• omx wiki: 로컬 문서 기반 검색과 관리

이 기능들은 필수는 아니지만, 대형 작업이나 장기 프로젝트에서 강력한 효과를 발휘합니다.

---

누가 OMX를 사용하면 좋은가

OMX는 다음과 같은 경우에 적합합니다.

• Codex CLI를 이미 자주 사용하는 개발자
• 작업 흐름을 표준화하고 싶은 팀
• 계획과 실행을 분리해 관리하고 싶은 경우
• 병렬 작업과 장기 실행이 필요한 환경

반대로, 단순히 Codex를 한두 번 호출하는 용도라면 OMX는 필요하지 않을 수 있습니다.

---

728x90

oh-my-codex(OMX)는 새로운 AI 도구가 아니라,
Codex를 제대로 쓰기 위한 실행 문화와 구조를 제공하는 도구입니다.

• 요청을 먼저 정리하고
• 계획을 승인한 뒤
• 실행을 끝까지 책임지게 만든다

이 단순한 원칙을 자동화했다는 점이 OMX의 가장 큰 가치입니다.
Codex를 “실험용 도구”가 아니라 일상적인 개발 파트너로 쓰고 싶다면,
OMX는 충분히 검토해볼 만한 선택지입니다.

300x250

https://github.com/Yeachan-Heo/oh-my-codex

GitHub - Yeachan-Heo/oh-my-codex: OmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.