애플리케이션
codex-unlock-stale
현재 VS Code Remote 확장 호스트는 남기고, Codex 대화 작성 잠금을 쥔 오래된 중복 호스트만 종료합니다.
로컬에서 사용 가능CLI
한눈에 보기
- 대상
- Linux 호스트에서 VS Code Remote SSH로 Codex를 사용하는 사람
- 주요 용도
- 중복 Codex app-server를 확인하고 세션 파일을 수정하지 않은 채 오래된 대화 작성 잠금을 해제합니다.
- 제품 상태
- 로컬에서 사용 가능
- 지원 환경
- CLI
개요
노트북 절전이나 네트워크 변경 뒤 이전 Remote SSH 확장 호스트와 현재 호스트가 함께 남을 수 있습니다. 이 Bash 도구는 중복 상태를 보여 주고 안전장치가 있는 정리 경로를 제공합니다.
사용 흐름
오래된 잠금 복구
합성 확장 호스트 두 개를 확인하고 진행 중일 수 있는 작업을 보호한 뒤 오래된 잠금만 해제합니다.
먼저 확인
사전 점검을 실행해 어느 확장 호스트를 남길지 확인합니다.
진행 중 작업 보호
오래된 호스트에 일반 하위 명령이 남아 있으면 자동으로 멈춥니다.
오래된 호스트에 진행 중인 작업이 있을 수 있으면 멈춥니다. 프로세스 ID와 실행 시간, 하위 명령은 모두 합성 데모 자료이며 대화 데이터는 읽지 않았습니다. 잠금 해제
하위 작업이 끝난 뒤 오래된 확장 호스트만 종료하고 현재 app-server 하나가 남았는지 확인합니다.
대화 파일을 수정하지 않고 오래된 잠금을 해제합니다. 프로세스 ID와 실행 시간, 하위 명령은 모두 합성 데모 자료이며 대화 데이터는 읽지 않았습니다.
주요 기능
- 사전 점검
- 최신 호스트 보존
- 활성 하위 작업 보호
- SIGTERM 우선 종료
- 대화 파일 접근 없음
데이터와 개인정보
프로세스 메타데이터만 읽습니다. ~/.codex 대화 파일을 읽거나 수정, 이동, 삭제하지 않으며 승인된 터미널 화면은 합성 프로세스 자료를 사용합니다.
기술 구성
언어
- Shell
런타임
- Linux
연결
- VS Code Remote SSH
기술 아이콘은 저장소에 포함된 범주 심볼이며, 실제 기술 이름을 함께 표시합니다.
Studio와의 관계
Studio 연결은 계획하지 않았습니다. 터미널에서 독립적으로 실행하는 복구 명령으로 유지합니다.
현재 상태
0.1.0 버전을 공개했으며 VS Code Remote SSH 재연결 뒤 Linux 셸에서 사용할 수 있습니다.
현재 한계
- 현재 OpenAI VS Code 확장 경로를 대상으로 하므로 설치 구조가 바뀌면 매처를 갱신해야 할 수 있습니다.
- 공식 OpenAI 복구 기능이 아니라 범위를 좁힌 사용자 도구입니다.
기술 메모
- Bash가 프로세스 확인과 안전한 시그널 전송을 조정합니다.
- Linux ps에서 부모 프로세스와 실행 시간, 명령 메타데이터를 읽습니다.
- VS Code Remote 확장 호스트와 Codex app-server 경로만 인식합니다.
다음 단계
- 확장 설치 구조가 바뀌어도 매처 검사를 유지합니다.
- 다른 Linux 원격 환경의 검증된 사례가 생기면 범위를 문서화합니다.
기술 사실
- 소스 출처
- Gnaroshi/codex-unlock-stale
- 소스 커밋
2a3485ba5168- Studio 연결 상태
- 계획 없음
- 내용 확인일
- 2026년 8월 26일