huzhongyyuan/watch-codex-session

watch-codex-session은(는) 무엇을 하나요?

Codex 스킬 및 tmux 감시자로, 429, 차단 또는 중단 상태 이후 인터랙티브 Codex 세션을 재개합니다.

개요

이 스킬은 Codex CLI 세션을 모니터링하고, 오류나 중단 발생 시 자동으로 재시작합니다. tmux를 사용하여 세션을 관리하며, 설정된 조건이 감지되면 이전 대화 컨텍스트를 유지합니다.

설치

1. tmux가 설치되어 있는지 확인하세요:

   tmux -V
   

   설치되어 있지 않다면, 패키지 관리자를 사용하여 설치하세요:

   # macOS (Homebrew)
   brew install tmux
   
   # Ubuntu/Debian
   sudo apt install tmux
   
   # Fedora
   sudo dnf install tmux
   

2. 저장소를 클론하거나 스크립트를 다운로드하세요:

   git clone https://github.com/huzhongyyuan/watch-codex-session.git
   cd watch-codex-session
   

3. 스크립트를 실행 가능하게 만드세요:

   chmod +x watch-codex-session.sh
   

사용법

기본 명령:

./watch-codex-session.sh

선택적 플래그:

• --session-name <name>: 감시할 tmux 세션 이름을 지정합니다 (기본값: codex-session).
• --retry-delay <seconds>: 재시도 전 대기 시간을 설정합니다 (기본값: 10초).
• --max-retries <number>: 최대 재시도 횟수를 설정합니다 (기본값: 5).

예시:

./watch-codex-session.sh --session-name my-codex --retry-delay 5 --max-retries 10

작동 방식

1. 감시자는 지정된 이름의 tmux 세션이 존재하는지 확인합니다.
2. 세션이 존재하면 해당 세션의 출력을 모니터링하여 429, blocked, stopped 등의 키워드를 감지합니다.
3. 이러한 키워드가 감지되면 현재 세션을 종료하고, 동일한 이름으로 새 Codex 세션을 시작합니다.
4. 재시도 횟수와 지연 시간을 준수하며, 모든 재시도가 실패하면 스크립트를 종료합니다.

요구 사항

• tmux >= 3.0
• Codex CLI가 시스템 PATH에 설치되어 있어야 함
• Unix 계열 운영 체제 (Linux, macOS)

문제 해결

• tmux 세션이 생성되지 않음: tmux가 올바르게 설치되었는지 확인하고, tmux new-session -s codex-session 명령으로 수동으로 생성해 보세요.
• Codex 명령을 찾을 수 없음: codex 명령이 $PATH에 있는지 확인하거나, 스크립트 내에서 절대 경로를 설정하세요.
• 권한 오류: chmod +x watch-codex-session.sh로 스크립트에 실행 권한을 부여했는지 확인하세요.

라이선스

MIT