Skip to content

Releases: Ishikawa-Hidekazu/codex-healthkit

codex-healthkit v0.2.0

Choose a tag to compare

@ishikawa-h ishikawa-h released this 26 Jul 23:28
7810e36

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.

v0.1.0-alpha.1

v0.1.0-alpha.1 Pre-release
Pre-release

Choose a tag to compare

@ishikawa-h ishikawa-h released this 06 Jul 00:24

Initial source-only alpha release.

  • Metadata-only local health reports for daily Codex operators
  • Default mode does not execute codex
  • Does not read credentials, tokens, cookies, SQLite contents, or session transcripts
  • Markdown and JSON output
  • Optional Codex CLI version and official doctor summary modes
  • Tested on macOS and Linux
  • No npm package, Homebrew formula, or binary artifacts yet