도구
OMX 런타임이 내부적으로 쓰는 capability 레이어
도구란
도구는 OMX가 작업을 진행하는 도중 내부적으로 쓰는 런타임 capability입니다. 사용자가 직접 호출하는 스킬과 달리, 도구는 스킬 · 훅 · 에이전트가 뒤에서 의존하는 하위 기능입니다.
스킬이 "무엇을 할지"를 정한다면, 도구는 "그걸 실제로 가능하게 하는 층"입니다.
도구가 있기 때문에 가능한 것
- 실행 중 상태를 저장하고 복원
- HUD로 진행 상황 표시
- wiki에 프로젝트 지식 누적
- 스크린샷 비교 같은 visual QA
- Claude / Gemini 등 다른 모델에 cross-CLI 위임
"사용자가 직접 누르는 버튼"보다 OMX가 왜 그렇게 움직이는지 이해할 때 보는 섹션에 가깝습니다.
주요 도구
State
State — 실행 중 모드의 상태를 읽고 쓰는 지점. $ralph, $team, $ultraqa 같은 장기 실행이 상태를 유지하는 기반입니다.
HUD
HUD — 현재 세션 상태를 보는 창구. phase, tmux status pane, JSON export 등.
Wiki
Wiki — .omx/wiki/ 아래에 지속성 프로젝트 지식을 쌓는 자리. State가 실행 중 정보라면, Wiki는 세션이 끝나도 남아야 하는 정보입니다.
Catalog
Catalog — OMX가 프롬프트 · 스킬 · 도구를 어떤 capability map으로 묶는지. 구조를 이해하고 싶을 때 봅니다.
Visual
Visual — 스크린샷과 참조 이미지 비교 capability. 보통 $visual-verdict를 통해 간접 사용됩니다.
Ask Claude / Ask Gemini
Ask Claude, Ask Gemini — 현재 Codex 컨텍스트 바깥에서 다른 모델에 서브 질문을 위임하는 브리지. second opinion, 오염 없는 요약, cross-CLI 비교에 씁니다.
도구 vs 스킬
| 구분 | 의미 |
|---|---|
| 스킬 | 사용자가 시작하는 워크플로우 |
| 도구 | 그 워크플로우가 의존하는 하위 capability |
한 워크플로우가 실행되면 내부에서 state 갱신 → wiki 저장 → HUD 업데이트 → visual 비교 같은 연쇄가 일어나지만, 사용자는 이런 개별 호출을 신경 쓸 필요가 없습니다.
언제 보면 유용한가
- OMX가 상태를 어디에 저장하는지 확인할 때
- HUD · wiki · state의 차이를 정리할 때
- visual QA나 provider bridge가 어느 레이어에 있는지 확인할 때
- 스킬 위에서 실제로 어떤 capability가 돌고 있는지 추적할 때
처음부터 정독할 필요는 없지만, OMX internals를 이해하려면 놓칠 수 없는 섹션입니다.