containers / Node.js CLI

healthcheck-gen

Generate a Docker health check from the image, command, and exposed port.

healthcheck-gen reads a Dockerfile and proposes a HEALTHCHECK instruction, a Compose block, or JSON output. It understands common application and service images and provides a matching endpoint snippet when it can infer a framework.

npm package Source on GitHub

Installation

npx @barissozudogru/healthcheck-gen

Platform requirements and configuration are documented in the repository instructions.

Capabilities

Inspect the final stage of multi-stage Dockerfiles
Choose probes for common Node, Python, Go, Postgres, Redis, and nginx images
Generate Dockerfile, Compose, or JSON output
Replace an existing HEALTHCHECK only when explicitly requested

Use cases

Adding a first health check to an existing container
Reviewing a generated probe before committing it
Producing consistent health-check configuration for CI automation

Evidence

verified public Dockerfile

A Node slim image gets a probe its runtime can actually execute.

The tool inspected the release-intel-mcp Dockerfile and detected Node 22 slim, Express, and port 3000 before choosing the built-in fetch API.

image      node:22-slim
framework  express
port       3000
probe      node fetch

Inspect the source

GitHub Actions

Generate a reviewable probe and apply it only when requested.

- uses: barissozudogru/[email protected]

Limitations

Framework and endpoint detection is heuristic
Verify the proposed path and command against the application before using append mode
A container health check does not replace end-to-end service monitoring