01
Codex CLI health check
codex-healthkit
stable / source available
Codex CLIのローカル環境を、機密情報や会話本文を読まずに点検するmetadata-onlyのヘルスチェックツールです。
目的
日々使うCodex環境の状態を、更新や不調の前後で安全に比較できるようにする。
向いている人
Codex CLIを継続利用し、sessionやSQLite WALの状態を最小限の情報で確認したい人。
できること
- sessionとSQLite WALのmetadataを確認
- JSON出力で更新前後を比較できる
- 実行時にCodexを起動せず、状態を変更しない
安全境界
- credentials、token、cookie、SQLite本文、session transcript本文を読まない
- データを外部へ送信しない
- 削除、圧縮、修復、自動クリーンアップをおこなわない
実行例
./bin/codex-healthkit check --json
Release fixture / 静的・再現可能
30秒でわかるCLIの証拠
リリースに同梱した合成fixtureで、通常のhealth reportと更新前後の比較結果を確認できます。
入力
./bin/codex-healthkit check --json
出力
status: okactive sessions: 18 MB / 42 files(metadataのみ)SQLite WAL: 6 MB(sizeのみ)comparison: WAL +3 MB / archived +2 files
この証拠が示すこと
- 表示値はリリース同梱の合成fixtureで、実環境の情報ではない
- credentials、SQLite本文、会話本文を出力しない
- 外部送信や自動クリーンアップをおこなわない