01
Codex CLI health check
codex-healthkit
stable / source available
A metadata-only health check for local Codex CLI environments that avoids credentials and conversation content.
Purpose
Safely compare the state of a regularly used Codex environment before and after updates or problems.
Who it is for
People who use Codex CLI continuously and want a minimal view of session and SQLite WAL metadata.
What it does
- Inspect session and SQLite WAL metadata
- Compare states through JSON output
- Run without starting Codex or changing local state
Safety boundary
- Does not read credentials, tokens, cookies, SQLite contents, or session transcript contents
- Does not send data to external services
- Does not delete, compact, repair, or run automatic cleanup
Example command
./bin/codex-healthkit check --json
Release fixture / static and reproducible
See the CLI in 30 seconds
A synthetic fixture included in the release shows a normal health report and a before-and-after comparison.
Input
./bin/codex-healthkit check --json
Output
status: okactive sessions: 18 MB / 42 files (metadata only)SQLite WAL: 6 MB (size only)comparison: WAL +3 MB / archived +2 files
What this proves
- Values come from a synthetic release fixture, not a real environment
- No credentials, SQLite contents, or conversation content are output
- No external upload or automatic cleanup is performed