CLI

LazyCodex가 제공하는 CLI는 하나, lazycodex-ai npm bin입니다. OmO 기반 Codex light 설정을 설치하고 진단합니다. 전역 설치는 없습니다 — 항상 npx로 호출합니다.

Forwarding to OmO

bin은 인자를 읽어 oh-my-openagent로 전달합니다. install 서브커맨드는 Codex 플랫폼을 고정하도록 특별 처리되고, 나머지는 그대로 통과합니다.

npx lazycodex-ai install

npx --yes --package oh-my-openagent omo install --platform=codex

npx lazycodex-ai install --no-tui --codex-autonomous
# → npx --yes --package oh-my-openagent omo install --platform=codex --no-tui --codex-autonomous

npx lazycodex-ai <args...>
# → npx --yes --package oh-my-openagent omo <args...>

--dry-run

--dry-run을 첫 인자로 두면 커맨드를 실행하는 대신 해석된 npx 커맨드를 출력하고 종료합니다:

npx lazycodex-ai --dry-run install --no-tui --codex-autonomous

출력:

npx --yes --package oh-my-openagent omo install --platform=codex --no-tui --codex-autonomous

--dry-run은 전달 전에 제거되므로, 남은 인자는 실제 실행과 정확히 동일하게 해석됩니다. 실행 전에 정확한 omo 호출을 확인할 때 사용하세요.

doctor

npx lazycodex-ai doctor

무엇이 설정되었고, 무엇이 빠졌고, 왜 그런지 보여 주는 health report를 출력합니다. 플러그인 캐시, hooks, MCP Servers, Agent Roles, Codex config state를 확인하므로 훅이 pending 상태이거나 스킬이 로드되지 않거나 라우팅이 이상할 때 먼저 실행하세요.

Marketplace Alternative

npx 설치가 기본 경로입니다. 추가적인 실험적 경로로 Codex에서 플러그인을 설치할 수 있습니다.

codex plugin marketplace add https://github.com/code-yeongyu/lazycodex
codex plugin add omo@sisyphuslabs

다음 Codex 시작 리뷰에서 omo hooks를 승인하세요. 첫 승인 세션은 background bootstrap을 실행하고, 완료 뒤 재시작을 안내합니다. 업그레이드는 다음으로 실행합니다.

codex plugin marketplace upgrade sisyphuslabs

업그레이드 후에는 플러그인 파일이 바뀌어 trust hash 재승인이 필요하므로 hooks가 Modified로 표시됩니다. 다시 승인하면 다음 세션에서 새 버전 bootstrap이 실행됩니다.

Exit Behavior

bin은 해석된 커맨드를 상속된 stdio로 실행하고, 그 커맨드의 상태 코드로 종료합니다. npx 자체 spawn에 실패하면 에러를 출력하고 0이 아닌 코드로 종료합니다.

In-session Commands

설치되면 LazyCodex는 OmO의 커맨드를 Codex 안에 등록합니다. 이들은 셸 명령이 아니라 Codex 세션 입력창에서 쓰는 $command입니다. 문법과 사용 흐름은 Commands에 모아 둡니다.

Related