Codex Cron은 터미널 기반의 로컬 환경에서 Codex 프롬프트를 주기적으로 자동 실행하기 위한 도구로, 사용자가 지정한 간격(loop) 또는 cron 표현식(schedule)에 따라 작업을 예약하고 실행할 수 있는 기능을 제공합니다. 이 도구는 별도의 OS 내장 cron이나 데몬 설치 없이, 사용자 터미널 환경 내에서 안전하게 구동되는 것을 목표로 합니다.

핵심 방법론 및 기술적 상세

1. 작업 예약 및 실행 방식:
   • loop: 10m, 2h, 1d와 같은 고정 시간 간격으로 작업을 반복합니다.
   • schedule: 5-필드 크론 표현식이나 --at <ISO-8601> 형식을 사용하여 특정 시점에 작업을 수행합니다.
   • Runner 시스템: 예약된 작업은 세 가지 방식을 통해 전달됩니다:
     • tmux-send: 지정된 tmux 창에 프롬프트를 입력하고 실행.
     • resume-command: 사용자가 정의한 로컬 후크 실행.
     • codex-exec: 표준적인 codex exec 명령으로 복귀.

2. 안전성 및 동시성 제어 (Single-runner lock):
   • 원자적(atomic)인 mkdir 및 rename 기반의 compare-and-swap 메커니즘을 사용하여 Single-runner lock을 구현합니다. 이는 작업이 중복 실행되는 것을 방지하며, 비정상적인 프로세스 종료 시에도 잠금 상태를 안전하게 복구합니다.
   • Safety allowlist: codex-exec 호출 시 위험한 플래그(예: --sandbox danger-full-access)가 전달되지 않도록 엄격한 화이트리스트 검증을 수행합니다.

3. 데이터 관리 및 로깅:
   • 모든 실행 결과는 $runs/<taskId>/<ts>.jsonl$ 및 last-message 파일에 기록되어 1MB 크기 제한 없이 보존됩니다.
   • 상태 정보(예: tasks.json, scheduled_tasks.lock/)는 로컬 디렉토리에 저장되며, git-ignore를 통해 원격 저장소에 커밋되지 않도록 설계되었습니다.

4. 기술적 구현 특징:
   • Zero-dependency: 순수 Node ESM 및 node:test 프레임워크로 작성되었습니다.
   • Daemon 구조: 데몬은 설정된 주기에 따라 tasks.json을 폴링하며 실행 시점이 도래한 작업을 run-due 로직으로 처리합니다.
   • 상태 무결성: 작업 관리 명령(add, list, cancel)은 임시 파일 작성 후 rename하는 방식을 사용하여 작업 데이터의 손실을 방지합니다.

이 도구는 Codex 사용자를 위한 터미널 네이티브 폴백 솔루션으로서, 인프라나 시스템 서비스에 의존하지 않고 로컬 쉘 환경에서 강력한 자동화 기능을 제공하는 데 최적화되어 있습니다.