它查看什么
每个文件夹都有自己的规则。
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_sessionsCodex worktree
桌面应用保留最新的 15 个,删除前会先做快照。
~/.codex/worktreesShell 快照
Codex 会自己删除超过 3 天的快照。
~/.codex/shell_snapshots插件
Codex 自己管理其插件。
~/.codex/plugins/cache桌面应用数据
应用的状态和内部数据库;从不直接编辑或删除。
~/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 查找。