代理 · Codex

Codex 在你的 Mac 上留下了什麼。

工作階段、已封存的工作階段、暫存 git 儲存庫、快取和 Codex worktree。Devbroom 會把它們全部找出來,並告訴你哪些由 Codex 自己管理、哪些留給你處理、哪些從不碰。

它查看什麼

每個資料夾都有自己的規則。

Devbroom 依照 Codex 自身的行為方式處理每個位置。代理會自己清理的交給代理;有專屬指令的交給那個指令。

逐項評估每一項都會單獨檢查;結果為可清理就能清理。
用 codex delete只能透過 Codex 自己的指令。Devbroom 把這些顯示為已鎖定,並告訴你該用的指令。
由 Codex 管理舊的由代理自己清理;Devbroom 只會顯示。
從不碰只顯示,從不刪除。

暫存 git 儲存庫

遺留的 git-* 暫存儲存庫。它們的用途沒有文件說明;清理前請先看一眼。

~/.codex/.tmp
逐項評估

快取和日誌

快取會在需要時重建;日誌只是日誌。

~/.codex/cache~/.codex/log~/Library/Logs/com.openai.codex
逐項評估

工作階段

手動刪除日誌檔案會在資料庫中留下失效的資料列。應使用 Codex 自己的指令 codex delete <id>。

~/.codex/sessions~/.codex/archived_sessions
用 codex delete

Codex worktree

桌面 App 會保留最新的 15 個,刪除前會先建立快照。

~/.codex/worktrees
由 Codex 管理

Shell 快照

Codex 會自己刪除超過 3 天的快照。

~/.codex/shell_snapshots
Codex 會刪除

外掛

Codex 自己管理它的外掛。

~/.codex/plugins/cache
從不碰

桌面 App 資料

App 的狀態和內部資料庫;從不直接編輯或刪除。

~/Library/Application Support/Codex~/.codex/*.sqlite
從不碰
受保護

你的帳號和設定原封不動。

這些檔案和資料夾受到保護。任何判定都不會讓它們進入清理範圍;不論多大,它們都留在原處。

憑證~/.codex/auth.json
設定~/.codex/config.toml
提示詞歷史~/.codex/history.jsonl
桌面資料庫~/.codex/sqlite
Worktree

透過痕跡辨識 Codex 的 worktree。

它根據這些痕跡判斷 worktree 是否屬於 Codex;痕跡越強,顯示的歸屬就越確定。

  • 確定git 中繼資料中 Codex 的 codex-thread.json 標記
  • 很可能位於 ~/.codex/worktrees 資料夾中
  • 可能以 codex/ 開頭的分支名稱
  • 含有未儲存的工作時為已鎖定。 沒有 --force,git 不會移除這樣的 worktree;Devbroom 從不使用 --force。
  • 其中或其上層資料夾有工作階段在執行時為已鎖定。
  • 含有被忽略的檔案時為需查看: git worktree remove 會不經詢問就刪除它們。
執行中的工作階段

看得見它們,執行時不打擾。

Devbroom 知道哪些 Codex 工作階段正在執行。它從不碰執行中工作階段的程序;工作階段持續期間,其資料夾會維持已鎖定。

相容性

先檢查 Codex 的檔案。

在信任某個代理的資料之前,Devbroom 會檢查其檔案是否符合預期格式。如果不符合,這些資料只會讀取;其中任何內容都不算可清理。

已測試的版本0.115.0 - 0.159.2

超出此範圍的版本只要格式不變仍可正常使用,並顯示為「尚未測試」。

格式檢查cwd

~/.codex/sessions 中的日誌檔案必須以一行帶有工作階段資料夾的中繼資料開頭。

你的版本devbroom compat

如果它的資料夾在別處,會依照 CODEX_HOME 尋找。

讓 Codex 去工作吧。Devbroom 負責善後。