Yeachan-Heo/oh-my-codex

oh‑my‑codex (OMX) – OpenAI Codex를 위한 워크플로우 계층

무엇인가요 – OMX는 공식 OpenAI Codex 명령줄 도구 위에 얇은 CLI 래퍼로 작동합니다. Codex의 코드 생성 엔진을 대체하지 않습니다. 대신 구조적이고 명확한 워크플로우, 지속 가능한 프로젝트 상태, 그리고 일상적인 프롬프트 작업을 더 반복 가능하게 만드는 재사용 가능한 "스킬"(명령어)을 추가합니다.

왜 존재하는가 – Codex를 사용하는 많은 개발자들이 동일한 단계를 반복해야 한다고 보고합니다: 작업 명확화 → 계획 생성 → 승인 → 계획 실행. OMX는 이 패턴을 $deep‑interview → $ralplan → $ultragoal (선택적 더 엄격한 변형 포함)로 정의하고 중간 결과물을 숨겨진 .omx/ 폴더에 저장합니다. 이를 통해 다음과 같은 이점을 얻을 수 있습니다:

• 단일 진입점 (omx) – 적절한 모델 설정(고성능 추론, 선택적 "madmax" 사전 승인 및 샌드박스 우회)으로 Codex 세션을 시작.
• 프로젝트 범위의 안내 – AGENTS.md 파일을 병합하거나 별도로 유지 가능.
• 지속 가능한 로그, 계획, 체크포인트 – 장시간 리팩터링을 재개하거나 감사할 수 있음.
• macOS/Linux용 tmux 기반 UI – 터미널을 HUD와 Codex 패널로 분할하여 멀티패널 상호작용을 원활하게.

설치 방법

# 이미 Codex CLI가 있는 경우
npm install -g oh‑my‑codex
# 그렇지 않다면 먼저 Codex 설치
npm install -g @openai/codex
npm install -g oh‑my‑codex

설치 후 한 번만 실행하는 설정을 수행합니다:

omx setup --scope project --merge-agents   # 관리하고자 하는 리포지토리 내에서 실행
# 또는
omx setup --scope user                     # 전역 사용자 설정용

정상 작동 여부를 확인합니다:

omx doctor                     # 종속성 및 런타임 파일 확인
omx exec -C . "Reply with exactly OMX‑EXEC‑OK"   # 실제 Codex 호출의 스모크 테스트

일반적인 워크플로우

1. 세션 시작 (격리 목적의 git worktree 권장):

   omx --worktree=feat/task --madmax --xhigh
   

2. 명확화 – $deep‑interview "…" – Codex에게 추가 질문을 하게 하고 문제 정의를 정밀화.
3. 계획 – $ralplan "…" – 구체적인 아키텍처/구현 계획을 얻고 승인.
4. 실행 – 실행 스파인 중 하나:
   • $ultragoal / $ultrawork – 지속적이고 체크포인트 기반 실행, .omx/ultragoal에 레저 저장.
   • $autopilot – 명확화에서 실행까지 완전한 감시된 루프.
   • $ralph – 간단한 작업에 적합한 단일 소유자 루프.
   • $prometheus‑strict – 고위험 변경에 대해 추가 비판 단계 추가.
5. 선택적 연구 – $best‑practice‑research, $autoresearch, $autoresearch‑goal로 계획 전 외부 증거를 가져옴.

핵심 개념 및 명령어

개념	의미	대표적 명령어
Worktree	실행 루트로 사용되는 격리된 git 체크아웃.	omx --worktree=feature/auth …
MADMAX	--dangerously-bypass-approvals-and-sandbox의 단축어; Codex의 안전 장치 비활성화(신뢰할 수 있는 리포지토리에서만 사용).
모델 노력	--high / --xhigh로 model_reasoning_effort 설정하여 Codex에 더 많은 계산 요청.
AGENTS.md	지속 가능한 안내 파일(전역 또는 프로젝트 범위), 역할, 안전 규칙, 라우팅 정의.
.omx/	계획, 로그, 메모리 스냅샷, 레저 파일이 저장되는 디렉터리.
스킬	내장된 명령어 단축어($deep‑interview, $ralplan, $ultragoal 등)로 특정 Codex 프롬프트 호출.
팀 모드	omx team으로 tmux 관리 멀티패널 세션 시작, 병렬 작업 가능.
직접 모드	omx --direct로 tmux UI 없이 Codex 실행, 기존 터미널 내에서 유용.

대상 사용자

• 이미 OpenAI Codex CLI에 익숙한데, 반복 가능하고 상태 유지 가능한 워크플로우를 원하는 개발자.
• AGENTS.md를 통해 프로젝트 수준의 안내가 필요하고, 계획과 실행 체크포인트 기록을 원하는 팀.
• macOS/Linux 사용자(기본적으로 완전히 지원되는 경로). Windows 지원은 있으나 안정성 낮음.

제한 사항 / 주의사항

• 주로 macOS/Linux에 최적화됨. Windows에서는 작동하지 않거나 불안정할 수 있음.
• "madmax" 플래그는 안전 검사를 비활성화하므로 신뢰할 수 있는 코드베이스에서만 사용.
• OMX는 작동하는 인증된 codex 바이너리에 의존하며, 인증 자체는 관리하지 않음.
• 시작 시 업데이트 확인. OMX_AUTO_UPDATE로 비활성화 또는 연기 가능.

프로젝트 건강 상태

• npm에 공개(oh‑my‑codex), 버전 배지로 활성 릴리스 표시.
• 원작자(Yeachan Heo)와 소수의 기여자 팀이 유지 관리.
• 가이드(시작 가이드, 에이전트, 스킬, 통합)가 풍부하며, 지원을 위한 Discord 커뮤니티 제공.

결론 – 이미 Codex를 사용하고 있지만 수동으로 프롬프트를 조율하고 있다면, OMX는 준비된 스크립터블 워크플로우, 지속 상태, 풍부한 터미널 UI를 제공하여 일시적인 프롬프트 엔지니어링을 반복 가능한 개발 프로세스로 전환합니다.