Yeachan-Heo/oh-my-codex

어떤 프로젝트인가요?

핵심 기능

• 01요구사항 명확화부터 계획 수립, 지속적인 실행까지 이어지는 표준 워크플로
• 02`.omx/ultragoal`에 체크포인트 원장을 기록하는 지속적인 다중 목표 실행
• 03tmux와 전용 git worktree를 활용한 병렬 에이전트 팀
• 04동시 세션을 위해 이름을 지정해 worktree를 격리하는 런처 래퍼
• 05상태 확인 및 재개 기능을 갖춘 순차 프롬프트 배치용 미션 러너
• 06세션 내보내기, 타임라인 및 토큰 사용량 확인 명령

활용 사례

• Codex가 코드를 수정하기 전에 막연한 기능 요청을 승인된 계획으로 구체화
• 세션을 넘나들며 체크포인트로 진행 상황을 기록하는 장시간 다단계 리팩터링 실행
• 큰 작업을 별도의 worktree에서 병렬 작업 레인으로 분할
• Codex 프롬프트 체크리스트를 묶어 차례대로 무인 실행

빠른 시작

1. 1

   npm으로 Codex CLI를 설치합니다(Homebrew로 이미 설치했다면 건너뛰세요)

   npm install -g @openai/codex
2. 2

   oh-my-codex를 전역으로 설치합니다

   npm install -g oh-my-codex
3. 3

   doctor 검사를 실행해 설치를 확인합니다

   omx doctor
4. 4

   git 프로젝트 안에서 OMX를 실행합니다

   omx

사용 전 알아둘 점

• !주로 macOS 또는 Linux용으로 설계되었습니다. 네이티브 Windows 지원은 제한적이며 일관되지 않게 작동할 수 있습니다.
• !Node.js 20 이상과 인증된 Codex CLI가 필요합니다.
• !권장되는 지속형 팀 런타임을 사용하려면 macOS 또는 Linux에 tmux가 필요합니다.
• !--madmax 플래그는 Codex 승인 및 샌드박스 보호 기능을 비활성화하므로 신뢰할 수 있는 환경에서만 사용하세요.

토픽

자주 묻는 질문

oh-my-codex은(는) 무엇인가요?

OpenAI Codex CLI에 구조화된 계획 수립, 지속적인 목표 실행, 병렬 에이전트 팀, `.omx/` 기반 상태 추적을 더하는 워크플로 및 런타임 레이어입니다. oh-my-codex(OMX)는 OpenAI Codex CLI 위에서 동작하는 워크플로 레이어입니다. 실행 엔진은 Codex가 맡고, OMX는 요구사항 명확화(`$deep-interview`)에서 계획 수립(`$ralplan`), 지속적인 다중 목표 실행(`$ultragoal`)로 이어지는 표준 흐름을 제공합니다. 스토리 단위로 협업하는 병렬 작업에는 `$team`을 사용할 수 있습니다.

oh-my-codex은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

oh-my-codex은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

oh-my-codex은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. oh-my-codex의 마지막 커밋은 2026년 10월 20일입니다.

oh-my-codex은(는) 어디에 사용할 수 있나요?

Codex가 코드를 수정하기 전에 막연한 기능 요청을 승인된 계획으로 구체화 세션을 넘나들며 체크포인트로 진행 상황을 기록하는 장시간 다단계 리팩터링 실행 큰 작업을 별도의 worktree에서 병렬 작업 레인으로 분할 Codex 프롬프트 체크리스트를 묶어 차례대로 무인 실행

oh-my-codex는 어떻게 설치하나요?

npm으로 Codex CLI를 설치합니다(Homebrew로 이미 설치했다면 건너뛰세요): npm install -g @openai/codex oh-my-codex를 전역으로 설치합니다: npm install -g oh-my-codex doctor 검사를 실행해 설치를 확인합니다: omx doctor git 프로젝트 안에서 OMX를 실행합니다: omx

oh-my-codex은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Yeachan-Heo/oh-my-codex