Dailin521/codex-provider-sync
C#0 / 0
Codex의 rollout 파일과 SQLite Provider 메타데이터를 동기화해 전환 뒤 사라진 세션을 복구하는 도구입니다.
TL;DR
OpenAI Codex 생태계용 독립형 CLI·Web UI·데스크톱 도구로, Provider 전환 뒤 Codex Desktop이나 /resume에서 사라진 세션의 가시성을 복구합니다. rollout 파일과 SQLite 인덱스의 Provider 메타데이터를 동기화하고 쓰기 전에 백업을 생성하며, 메시지 본문과 인증 정보는 수정하지 않습니다. Node.js 16.20.2 이상에서 CLI와 로컬 Web UI를 사용할 수 있고 Windows GUI도 별도로 배포됩니다. 다만 다른 Provider나 account가 기존 encrypted_content를 해독하지 못하면 대화 계속 진행이나 compact는 실패할 수 있습니다.
핵심 포인트
- OpenAI Codex 생태계용 독립형 Provider 동기화 도구입니다. rollout 파일과 SQLite 인덱스의 Provider 메타데이터를 맞춰 전환 뒤 사라진 세션을 다시 표시합니다. Node.js CLI·Web UI와 Windows GUI를 제공해 사용 환경에 맞는 진입점을 고를 수 있습니다.
- sync와 switch 실행 전에 Codex Home 아래 백업을 만들고 메타데이터만 수정합니다. 메시지 본문, 세션 제목, 인증 정보, auth.json, updated_at은 건드리지 않습니다. SQLite가 사용 중이거나 활성 세션이 파일을 잠그면 Codex와 관련 프로세스를 종료한 뒤 다시 실행해야 합니다.
- CLI는 Node.js 16.20.2 이상에서 npm 패키지로 설치하며 status, sync, switch, restore, watch 명령을 지원합니다. Web UI는 로컬 Node 서버로 동작하고 기본적으로 127.0.0.1에만 연결됩니다. Windows에서는 Releases의 실행 파일을 사용할 수 있고 macOS는 CLI 기반 Web UI 또는 별도 GUI 빌드 경로를 사용합니다.
- Provider 메타데이터를 맞춰도 다른 Provider나 account가 기존 encrypted_content를 해독한다는 보장은 없습니다. 이 경우 이전 대화의 계속 진행이나 compact가 실패할 수 있어 원래 Provider로 돌아가거나 새 세션을 시작해야 합니다. 따라서 세션 가시성 복구에는 적합하지만 Provider 간 대화 호환성까지 해결하는 도구는 아닙니다.
이미지 분석

3.2k
Stars
141
Forks
+204
Trending
0
조회수
3.2k watchers8 open issuesMIT License
관련 토론
아직 관련 토론이 없습니다.
댓글
댓글을 작성하려면 로그인이 필요합니다.