훅
OMX가 Codex CLI 라이프사이클에 어떻게 개입하는지
훅이란
훅은 Codex CLI의 라이프사이클 이벤트에 반응해 자동으로 실행되는 런타임 코드입니다. OMX는 훅 위에서 돌아갑니다 — 사용자가 매번 내부 명령을 기억하지 않아도 스킬이 자연스럽게 활성화되고, 상태가 세션 사이에 이어집니다.
사용자가 직접 호출하는 기능이 아니라, OMX를 뒤에서 굴리는 이벤트 레이어입니다.
훅이 없으면
훅 없이는 OMX가 사실상 프롬프트 모음에 가까워집니다. 훅이 있기 때문에:
- 사용자 입력에서 매직 키워드를 감지하고
- 스킬을 자동 활성화하고
- 도구 실행 전후에 가드를 걸고
- 장기 실행 모드의 상태를 복원하며 이어 가고
.omx/에 런타임 상태를 저장
할 수 있습니다.
훅이 끼어드는 지점
| 시점 | OMX가 하는 일 |
|---|---|
| 세션 시작 | 상태 복원, 컨텍스트 주입, 초기 점검 |
| 프롬프트 제출 | 매직 키워드 감지, 스킬 활성화 |
| 도구 실행 전 | 위험 명령 가드, 사전 검증 |
| 도구 실행 후 | 실패 힌트 표면화, 후처리 |
| 모델 정지 | 미완료 실행을 이어갈지 판단 |
서브 페이지
- 라이프사이클 이벤트 — Codex CLI가 주는 이벤트와 OMX의 개입 지점
- 코어 훅 — 키워드 감지, 스킬 라우팅, 실행 강제
- 컨텍스트 훅 — notepad · project memory · compaction · 상태 지속성
- 매직 키워드 — 자연어 문구와
$skill이 어떤 워크플로우로 연결되는지 - Codex 네이티브 훅 — OMX가 실제로 쓰는 Codex 훅 통합 지점
언제 이 섹션을 먼저 보나
- 왜 특정 스킬이 저절로 켜졌는지 궁금할 때
- 실행이 왜 막히거나 왜 계속됐는지 추적할 때
- 장기 실행 모드가 어떤 상태를 복원하는지 확인할 때
.omx/상태와 런타임 동작의 연결을 이해할 때
"OMX가 왜 이렇게 움직였지?"라는 질문이 생기면 여기서 시작하면 됩니다.