heal-cli-0.2.1 has been yanked.

heal

hook-driven evaluation & autonomous loop — a code-health harness that turns codebase decay signals into work for AI coding agents.

LLM coding agents are usually reactive: a human files a task before the agent moves. Codebases, meanwhile, decay continuously — complexity creeps, hotspots shift, duplicates accumulate. heal closes that gap with an observe → calibrate → check → fix loop, turning codebase state changes into agent triggers.

Documentation: https://kechol.github.io/heal/

⚠️ Status: v0.2 in progress. macOS / Linux only.

Install

Pick whichever fits your environment.

brew install kechol/tap/heal-cli                # macOS / Linux
cargo install heal-cli                          # Rust toolchain
curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/kechol/heal/releases/latest/download/heal-cli-installer.sh | sh

Details: Installation.

Quick Start

Three commands inside any git repository:

heal init                     # set up .heal/, calibrate, install hook, offer Claude plugin
heal check                    # render the Severity-grouped TODO list
claude /heal-code-fix         # drain it, one finding per commit

Full walkthrough: Quick Start.

Documentation

Topical pages on the docs site:

Concept — design idea in three minutes
Metrics — what each metric measures, how Severity is assigned
CLI — every subcommand
Configuration — thresholds, toggles, calibration
Claude plugin — /heal-code-check + /heal-code-fix contracts
Architecture — internals

Development

Standard workspace commands; CI runs all five on push / PR.

cargo build  --workspace
cargo test   --workspace
cargo fmt    --all
cargo clippy --workspace --all-targets -- -D warnings
cargo deny   check

Project conventions live in CLAUDE.md.

License