TL;DR

  • FreshThread는 Windows용 Codex 동반 앱으로, 작업 활동과 컨텍스트 상태를 보여주고 목표·제약 조건·완료한 작업·다음 단계를 담은 인계 내용을 검토·승인한 뒤 새 작업에서 이어가게 함.
  • 패널은 세션을 따라 실시간으로 갱신되며 디스크 사용량, 세션 압력, 압축 전후 컨텍스트 사용량, 현재 컨텍스트 점유율을 표시함.
  • 활동 지표는 압축 횟수, 완료 및 중단된 응답 주기, 토큰 사용량을 집계하며, 토큰 사용량에는 현재 컨텍스트뿐 아니라 완료·중단된 응답 주기의 기록도 포함됨.
  • 공개 베타는 2026년 9월 24일 11:00부터 10월 1일 11:00까지 부다페스트 시간 기준으로 진행되며, 참가자 제한이 없고 계정 없이 사용할 수 있음.
  • 체크포인트는 Windows에서 로컬 저장·암호화되고, 버그 보고서는 검토 후 전송을 선택한 경우에만 비공개로 제출되며 최대 30일 보관됨.

FreshThread 소개

  • FreshThread는 Codex용 Windows 동반 앱으로, 작업 활동을 표시하고 현재 작업 컨텍스트를 유지한 채 새 작업에서 이어가도록 지원함.
  • 패널은 사용 가능한 컨텍스트 사용량, 완료된 턴, 압축 횟수, 인계 준비 상태를 표시함.
  • 인계 내용에는 목표, 제약 조건, 완료한 작업, 다음 단계가 요약됨. 새 작업으로 이동하기 전에 내용을 검토하고 승인하며, 시작 시점은 사용자가 선택함.

패널 읽기

  • 패널은 작업 중 실시간으로 갱신되며, Codex가 새 활동과 측정값을 보고할 때 선택된 세션을 따라감.

크기와 컨텍스트

  • MiB: 마지막으로 읽었을 때 세션 데이터가 디스크에서 차지한 누적 크기임.
  • 세션 압력(Session pressure): 상태값으로 표시되는 세션 전반의 압력임.
  • 마지막 압축(Last compaction): 가장 최근 압축 전후의 컨텍스트 사용량임. 오른쪽 값은 작업을 이어갈 때의 시작 부하임.
  • 컨텍스트 부하(Context load): 마지막 측정 시점의 현재 컨텍스트 점유율임.
  • 88.5% → 17.1%은 작업 재개 시 컨텍스트의 17.1%가 이미 점유된 상태임을 뜻함. 시작 점유율이 높을수록 새 작업에 쓸 여유가 줄어듦.
  • 세션이 커지면 모델이 현재 작업에 더는 유용하지 않은 세부 정보도 더 많이 이어받을 수 있음.

세션 활동

  • 압축(Compactions): 이 세션에서 기록된 컨텍스트 압축 횟수임.
  • 완료된 턴(Completed turns): 완료된 응답 주기 수임. 각 주기에는 여러 도구 호출이 포함될 수 있음.
  • 중단됨(Interrupted): 중단된 응답과 같이 중단 상태로 기록된 응답 주기 수임.
  • 토큰 사용량(Token use): 현재 컨텍스트만이 아니라 완료되거나 중단된 턴 전반에서 기록된 토큰 사용량임.

새 작업에서 이어가기

  • 인계(Handoff): 작업 컨텍스트를 새 작업으로 가져갈 준비가 됐는지를 나타냄. 시작 시점은 사용자가 선택함.

베타 상태

  • 7일 공개 베타를 이용할 수 있으며, Windows x64 설치 파일은 이 저장소의 Releases에서 다운로드 가능함. 소스 코드는 비공개로 유지됨.
  • 베타 기간은 릴리스 날짜부터 7일이며 모든 참가자에게 마감 시각이 동일함. 패치를 설치해도 기간은 연장되지 않음.
  • FreshThread 계정은 필요하지 않음. 마감 확인은 로컬 시계를 사용해 오프라인으로 실행되며, 만료 후에도 사용자 데이터, 버그 보고, 업데이트를 계속 이용할 수 있음.
  • 베타 기간은 2026년 9월 24일 11:00부터 2026년 10월 1일 11:00까지이며, 기준 시간대는 부다페스트 시간임. 참가자 수 제한은 없음.

시작하기

  • Windows x64 설치 파일을 이 저장소의 Releases에서 다운로드함.
  • Codex를 사용하는 Windows 계정에 설치함.
  • 설치 중 Codex가 실행 중이었다면 File → Quit ChatGPT를 선택해 완전히 종료한 뒤 Codex를 다시 시작함. 창만 닫으면 Codex가 계속 실행 중일 수 있음.
  • Settings → Hooks에서 FreshThread 훅을 활성화함.
  • FreshThread 패널을 열어 작업 활동을 확인하거나 인계를 시작함.
  • 설치 파일에는 Windows 게시자 서명(Authenticode)이 없으므로 Windows에서 알 수 없는 게시자 경고가 표시될 수 있음. Windows 보호 기능을 비활성화하지 않음.
  • 자동 업데이트에는 별도의 서명 검증이 필요함. 다운로드 해시만으로 파일의 게시자를 증명할 수 없음.

테스트할 항목

  • 시작 및 훅 설정.
  • Projects와 Recents에서 연 작업, 작업 전환, 빈 작업.
  • 다양한 해상도와 Windows 배율에서의 패널 위치 및 비율.
  • 턴 완료 후 측정값, 비공개 콘텐츠가 없는 일회용 작업을 사용한 인계.
  • 업데이트가 설정과 훅을 보존하는지 여부. 일상적으로 사용하는 컴퓨터에서 설치를 일부러 중단하는 행위는 피함.
  • 알려진 제한 사항은 릴리스 노트에서 확인함. 해결 방법을 찾았더라도 예상하지 못한 동작을 보고함.

문제 보고

  • 베타에서는 FreshThread 트레이 메뉴 → Report a bug를 선택함. 진단 미리보기를 검토하고 문제 설명을 선택적으로 작성한 뒤 Send report를 선택해 비공개 보고서를 제출함.
  • 계정은 필요하지 않으며 Send report를 선택하기 전에는 어떤 데이터도 업로드되지 않음.
  • GitHub를 선호하는 경우 Copy diagnostics와 Report on GitHub를 이용할 수 있음. GitHub 이슈는 공개되며 GitHub 계정이 필요함.
  • 기존 이슈를 검색한 뒤 Issues → New issue → Bug report를 선택함. 다음 정보를 포함함:
  • FreshThread 빌드, Codex 버전, Windows 버전, 디스플레이 배율.
  • 문제 재현 단계.
  • 기대한 동작과 실제 발생한 동작.
  • 이슈는 공개됨. 스크린샷과 선택적 진단 정보에서 비공개 정보를 제거함. 대화 내용, 데이터베이스, 인증 정보, 계정 식별자, 원시 진단 폴더는 업로드하지 않음.
  • 보안 취약점은 공개 이슈가 아니라 비공개 보고 경로를 통해 보고함.

데이터

  • FreshThread는 컨텍스트 체크포인트를 로컬에 저장하고 Windows에서 암호화함.
  • 인계는 Codex를 통해 실행됨. 모델 기반 준비 과정에서 Codex의 모델 제공자가 사용될 수 있음.
  • 베타 마감 확인은 데이터를 전송하지 않고 로컬에서 실행됨.
  • 버그 보고서는 검토 후 Send report를 선택해야 비공개로 전송됨. 보고서에는 선택적으로 작성한 설명이 포함될 수 있으며 최대 30일 동안 보관됨.

업데이트

  • 베타 설치본은 시작할 때와 15분마다 서명된 업데이트를 확인함. 설치는 Codex 작업이 안전하게 멈출 때까지 대기함.
  • 새 베타 릴리스는 Releases에도 표시됨. 패치를 설치해도 7일 마감 시한은 다시 시작되지 않음.