智能体 · 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

桌面应用保留最新的 15 个,删除前会先做快照。

~/.codex/worktrees
由 Codex 管理

Shell 快照

Codex 会自己删除超过 3 天的快照。

~/.codex/shell_snapshots
Codex 会删除

插件

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 查找。

让 Codex 去工作吧。Devbroom 负责善后。