@fallow-cli/fallow-cov
Runtime coverage analyzer sidecar for the fallow CLI.
What this is
fallow-cov is a closed-source sidecar binary that powers the paid
fallow health --runtime-coverage feature. It reads V8 or Istanbul
coverage dumps, cross-references them with fallow's static analysis, and
emits combined dead-code verdicts.
You should not invoke fallow-cov directly. Install it alongside the main
fallow CLI and let fallow health --runtime-coverage spawn it.
Install
npm install -g fallow # public CLI, MIT
npm install -g @fallow-cli/fallow-cov # private sidecar (paid)
fallow license activate --trial --email [email protected]
fallow health --runtime-coverage ./coverage
The postinstall step verifies that the correct platform-specific package was
installed and symlinks the binary into ~/.fallow/bin/fallow-cov, where the
fallow CLI looks it up by default.
Discovery precedence
The fallow CLI looks for the sidecar in this order:
$FALLOW_COV_BIN(explicit override, always wins)$FALLOW_COV_BINARY_PATH(air-gap / pre-placed binary)~/.fallow/bin/fallow-cov(installed by this package)fallow-covon$PATH
Signature verification
Every sidecar binary is signed with the fallow binary-signing Ed25519 key
(separate from the license-signing key). The fallow CLI verifies the
.sig file next to the binary on every spawn; an unsigned binary will not
run.
License
Proprietary. See LICENSE and https://fallow.tools/terms.