codex-healthkit v0.2.0

codex-healthkit v0.2.0

codex-healthkit is an on-demand, metadata-only health check for Codex CLI
operators. It helps review session-directory and SQLite WAL growth without
opening credentials, SQLite contents, or session transcript contents.

Highlights

• A clearer 30-second path from clone to a reviewable local health report.
• Explicit before/after comparison from one user-selected JSON report.
• A fixture-only 24-second terminal demo.
• Three concrete operating uses: update comparison, daily growth review, and
  preparing a redacted support report.
• Clearer known limitations and safety boundaries in English and Japanese.

Safety Boundary

The default check:

• does not execute codex;
• does not read credentials, tokens, cookies, SQLite contents, or transcript
  contents;
• does not upload data;
• does not delete, archive, compact, or clean up files;
• does not run a daemon, dashboard, telemetry process, or automatic history.

Optional --with-codex-doctor explicitly runs the installed official Codex CLI
doctor and may perform provider reachability checks. Raw doctor output is not
included in the report.

Installation

git clone --branch v0.2.0 --depth 1 https://github.com/Ishikawa-Hidekazu/codex-healthkit.git
cd codex-healthkit
./bin/codex-healthkit check

The project remains source-only. Homebrew, npm, binary artifacts, and automated
cleanup are not part of this release.

Known Limitations

• The report observes sizes and counts; it does not identify root cause.
• It does not repair Codex state or perform SQLite integrity checks.
• It does not report account usage, quota, or rate limits.
• Windows is not supported by the Bash implementation.
• Comparison mode requires jq and one explicit previous JSON report.

The opt-in macOS runtime diagnostics draft is not included in this release.