keep-codex-fast은(는) 무엇을 하나요?
로컬 Codex 상태를 빠르고, 깨끗하며, 복구 가능하게 유지하기 위한 백업 우선 Codex 스킬입니다.
이 스킬은 Codex 작업 중 발생할 수 있는 로컬 상태의 성능 저하와 데이터 손실을 방지합니다. 정리(cleanup), 백업(backup), 복원(restore) 명령을 자동화하여 Codex 환경을 항상 최적 상태로 유지할 수 있습니다.
주요 기능
- 상태 정리: 오래된 히스토리, 임시 파일, 불필요한 캐시를 제거하여 디스크 공간을 확보하고 응답 속도를 개선합니다.
- 백업 생성: 현재 Codex 상태(설정, 색인, 대화 기록 등)를 지정된 백업 디렉터리에 안전하게 저장합니다.
- 빠른 복원: 백업 파일을 사용하여 손상되거나 느려진 Codex 상태를 이전 정상 상태로 신속히 되돌립니다.
- 자동화 지원: 주기적인 정리 및 백업을 위한 cron 작업 또는 CI/CD 통합이 가능합니다.
사용법
스킬 활성화
Codex 환경에서 이 스킬을 활성화하려면 Codex 설정 파일(.codex/config.yaml 또는 환경 변수)에 추가합니다.
skills:
- name: vibeforge1111/keep-codex-fast
config:
backup_dir: ~/.codex/backups
cleanup_interval_days: 7
max_backups: 10
명령어
keep-codex-fast clean- 로컬 Codex 상태를 정리합니다.keep-codex-fast backup- 현재 상태를 백업합니다.keep-codex-fast restore- 가장 최근 백업에서 상태를 복원합니다.keep-codex-fast status- 현재 상태 크기 및 백업 현황을 확인합니다.
예제
# 상태 정리 (불필요한 파일 제거)
codex run keep-codex-fast clean
# 수동 백업 생성
codex run keep-codex-fast backup
# 백업 목록 확인
codex run keep-codex-fast status
# 특정 백업에서 복원 (예: 2025-01-15의 백업)
codex run keep-codex-fast restore --date 2025-01-15
환경 변수
| 변수명 | 설명 | 기본값 |
|---|---|---|
CODEX_CLEANUP_INTERVAL | 정리 실행 간격 (일) | 7 |
CODEX_BACKUP_DIR | 백업 저장 경로 | ~/.codex/backups |
CODEX_MAX_BACKUPS | 보관할 최대 백업 수 | 10 |
참고 사항
- 백업 디렉터리는 자동으로 생성됩니다.
- 복원 시 현재 상태는
~/.codex/backups/last_state에 자동 백업됩니다. - 이 스킬은 Codex CLI v1.2.0 이상과 호환됩니다.
- Windows, macOS, Linux에서 동작합니다.
라이선스
MIT