フォルダごとに、それぞれのルール。
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 に従います。