Install the Health.md CLI

Choose one installation method. The standalone CLI is a public preview for macOS, Linux, and Windows. The Health.md Mac app also includes signed helpers for Mac users.

Availability audit (2026-10-02): alpha.6 is published with uploaded installers, archives, and checksum/signature assets. Alpha.7 remains an unpublished draft with no assets and is not an install target. Neither publication nor a successful pairing qualifies a stable CLI/mobile pair. See release status for the separate qualification boundary.

Homebrew

Homebrew is the shortest path on macOS or Linux:

brew install CodyBontecou/tap/healthmd
healthmd --version

The formula currently serves alpha.6 and installs both healthmd and the healthmd-mcp compatibility launcher from the same versioned CLI release. Check the installed version; do not assume the tap matches development source.

To upgrade later:

brew update
brew upgrade healthmd

Health.md for Mac

Health.md for Mac includes signed healthmd and healthmd-mcp helpers. Open the Mac app and select CLI to see the commands for your installed copy.

The normal app bundle paths are:

/Applications/Health.md.app/Contents/Helpers/healthmd
/Applications/Health.md.app/Contents/Helpers/healthmd-mcp

To make them available in every terminal session, create symlinks in a user-owned bin directory:

mkdir -p ~/.local/bin
ln -sf "/Applications/Health.md.app/Contents/Helpers/healthmd" ~/.local/bin/healthmd
ln -sf "/Applications/Health.md.app/Contents/Helpers/healthmd-mcp" ~/.local/bin/healthmd-mcp

Add ~/.local/bin to PATH if your shell does not already include it.

Release installers and Cargo

Use the published healthmd-cli/v0.1.0-alpha.6 preview for checksummed installers and archives on macOS, Linux, and Windows. Before choosing a newer version, require a non-draft release with nonempty uploaded assets, sha256.sum, and sha256.sum.sigstore.json; a tag or draft alone is insufficient. Follow the release verification and installation instructions rather than the repository-wide latest-release link, which is reserved for the Apple apps.

After an exact version reaches crates.io, Rust users can install it with:

cargo install healthmd-cli --locked

Verify the installation

These commands are local and do not contact a phone:

healthmd --version
healthmd --help

Both should resolve to the same installation you intended to use:

command -v healthmd
command -v healthmd-mcp

Next step

Pair an open Health.md app on iPhone or Android:

healthmd direct pair --transport manual-ip

Or configure a supported local AI host and begin pairing in one flow:

healthmd setup codex

See Direct phone CLI for mobile requirements, transport behavior, and the current preview compatibility matrix.