GitHub 오픈소스 탐험

최근 많은 개발자들이 Codex를 사용하여 모델을 활용하고 있지만, 여러 프로바이더 간에 세션 데이터가 일관되지 않아 혼란을 겪는 경우가 많습니다. 특히 프로바이더를 바꿀 때마다 이전의 세션이 사라져 버리거나, 제대로 표시되지 않는 문제가 발생할 수 있는데요. 이 문제를 해결해주는 도구가 바로 Codex Provider Sync입니다.

이 도구는 Codex의 세션 프로바이더 메타데이터를 롤아웃 파일 및 SQLite 상태에 따라 동기화해 줍니다. 즉, 모델 프로바이더를 변경한 후에도 이전의 세션을 쉽게 복원하고 확인할 수 있도록 도와줍니다. 이번 포스트에서는 이 유용한 도구를 설치하고 사용하는 방법을 자세히 알아보겠습니다.

Codex Provider Sync, 어떤 문제를 해결하나요?

Codex에서 model_provider를 변경했을 때, 이전의 세션이 Desktop 또는 /resume에서 보이지 않는 경우가 종종 발생합니다. 이는 단순히 세션 파일이 사라지기 때문이 아니라, 다양한 메타데이터 간의 불일치로 인해 발생합니다. 이 도구는 다음의 위치에서 메타데이터를 동기화하여 문제를 해결합니다:

~/.codex/sessions
~/.codex/archived_sessions
~/.codex/state_5.sqlite
.codex-global-state.json의 프로젝트 경로 캐시

설치 및 기본 사용법

Windows 사용자

CodexProviderSync.exe 파일을 다운로드합니다.
다운로드한 파일을 열어 Refresh 버튼을 클릭합니다.
원하는 프로바이더를 선택합니다.
Execute 버튼을 클릭하여 동기화를 실행합니다.

macOS 사용자

macOS에서는 Avalonia 데스크톱 버전을 사용할 수 있습니다. 자세한 빌드 설명은 [README_MAC_GUI_ZH.md](docs/README_MAC_GUI_ZH.md)를 참조하세요.

CLI 사용법

다른 환경에서 CLI를 사용하려면 Node.js가 필요합니다. Node.js 16 이상을 설치한 후, 다음 명령어로 CLI를 설치합니다:

npm install -g git+https://github.com/Dailin521/codex-provider-sync.git
codex-provider sync

CLI의 주요 명령어는 다음과 같습니다:

codex-provider status                   # 현재 상태 진단
codex-provider sync                     # 메타데이터 동기화
codex-provider sync --provider openai   # OpenAI 프로바이더로 동기화
codex-provider switch apigather         # 프로바이더 변경
codex-provider restore <backup-dir>     # 백업에서 복원
codex-provider prune-backups --keep 5   # 오래된 백업 정리

실무 활용 시나리오

이 도구는 특히 여러 가지 프로바이더를 사용하고 있는 개발자에게 유용합니다. 예를 들어 OpenAI와 같은 여러 모델을 동시에 사용하는 경우, 매번 프로바이더를 변경할 때마다 이전의 세션을 복원하는 것이 번거로울 수 있습니다. 이때 Codex Provider Sync를 사용하면 이전 세션을 쉽게 확인하고 복원할 수 있으므로 작업 흐름이 크게 개선됩니다.

비슷한 도구와의 비교

Codex Provider Sync는 주로 역사적인 세션의 가시성을 복원하는 데 초점을 맞추고 있습니다. 다른 도구들은 종종 세션 내용을 직접 수정하거나, 로그인을 관리하는 데 중점을 두지만, 이 도구는 오로지 메타데이터 동기화에 특화되어 있습니다. 즉, 이 도구는 세션의 내용을 수정하거나 삭제하지 않으므로, 데이터 손실의 위험 없이 안전하게 사용할 수 있습니다.

Codex 세션을 손쉽게 동기화하는 방법