폴더마다 고유한 규칙이 있습니다.
Devbroom은 모든 위치를 Codex의 동작 방식에 맞춰 다룹니다. 에이전트가 스스로 정리하는 것은 에이전트에게 맡기고, 자체 명령이 있는 것은 그 명령에 맡깁니다.
임시 git 저장소
남겨진 git-* 임시 저장소. 용도가 문서화되어 있지 않으니 정리하기 전에 살펴보세요.
~/.codex/.tmp캐시와 로그
캐시는 필요할 때 다시 만들어지고, 로그는 로그일 뿐입니다.
~/.codex/cache~/.codex/log~/Library/Logs/com.openai.codex세션
로그 파일을 직접 지우면 데이터베이스에 오래된 행이 남습니다. Codex 자체 명령인 codex delete <id>를 써야 합니다.
~/.codex/sessions~/.codex/archived_sessionsCodex 워크트리
데스크톱 앱이 최신 15개를 유지하고, 삭제하기 전에 스냅샷을 만듭니다.
~/.codex/worktrees셸 스냅샷
3일보다 오래된 것은 Codex가 스스로 지웁니다.
~/.codex/shell_snapshots플러그인
Codex가 플러그인을 관리합니다.
~/.codex/plugins/cache데스크톱 앱 데이터
앱의 상태와 내부 데이터베이스. 직접 수정하거나 삭제하지 않습니다.
~/Library/Application Support/Codex~/.codex/*.sqlite계정과 설정은 그대로 둡니다.
이 파일과 폴더는 보호됩니다. 어떤 판정도 이것들을 정리 대상으로 만들지 않으며, 크기와 상관없이 그대로 남습니다.
~/.codex/auth.json~/.codex/config.toml~/.codex/history.jsonl~/.codex/sqliteCodex의 워크트리를 흔적으로 알아봅니다.
다음 흔적으로 워크트리가 Codex의 것임을 알아봅니다. 흔적이 강할수록 소유자를 더 확실하게 표시합니다.
- 확실git 메타데이터의 Codex
codex-thread.json표식 - 유력
~/.codex/worktrees폴더 안 - 가능성 있음
codex/로 시작하는 브랜치 이름
- 저장되지 않은 작업이 있으면 차단됨. git은
--force없이 이런 워크트리를 제거하지 않으며, Devbroom은--force를 절대 쓰지 않습니다. - 그 안이나 상위 폴더에서 세션이 실행 중이면 차단됨.
- 무시된 파일이 있으면 검토 필요:
git worktree remove는 묻지 않고 그 파일들을 지웁니다.
보이지만, 실행 중에는 건드리지 않습니다.
Devbroom은 어떤 Codex 세션이 실행 중인지 압니다. 실행 중인 세션의 프로세스는 절대 건드리지 않으며, 세션이 이어지는 동안 그 폴더는 차단됨으로 남습니다.
Codex의 파일부터 확인합니다.
에이전트의 데이터를 신뢰하기 전에, Devbroom은 파일이 예상한 형식인지 확인합니다. 그렇지 않으면 그 데이터는 읽기만 하며, 어느 것도 정리 준비됨으로 간주하지 않습니다.
이 범위를 벗어난 버전도 형식이 맞으면 동작하며, “아직 테스트되지 않음”으로 표시됩니다.
~/.codex/sessions의 로그 파일은 세션 폴더를 담은 메타데이터 줄로 시작해야 합니다.
폴더가 다른 곳에 있으면 CODEX_HOME 값을 따릅니다.