Installation

LPM ships a single binary, distributed through several channels. Pick whichever fits your workflow — they install the same release.

npm

npm install -g @lpm-registry/cli

Works on every supported platform, including Windows. The npm package is a dependency-free launcher; npm installs the matching platform-native Rust package through optionalDependencies.

If your npm config omits optional dependencies (--omit=optional, --no-optional, or a package-manager policy), reinstall with optional dependencies enabled.

Homebrew (macOS, Linux)

brew tap lpm-dev/lpm
brew install lpm

The formula auto-updates with every release.

Standalone installer (macOS, Linux)

curl -fsSL https://lpm.dev/install.sh | sh

Downloads the latest binary into ~/.lpm/bin and adds it to your PATH (.zshrc, .bashrc, or config.fish depending on your shell). Open a new terminal — or source the rc file — and you're done.

For Windows, use the npm installer above.

From source (Cargo)

cargo install --git https://github.com/lpm-dev/rust-client lpm-cli

Builds from the latest main. Requires Rust 1.94 or newer.

Verify

lpm --version
# lpm 0.41.0

lpm doctor

lpm doctor runs a project-and-environment health check (Node detection, registry reachability, store integrity, sandbox availability). Pass --fix to auto-repair what it can.

Updating

lpm self-update

Pulls the latest release for whichever channel you installed from, pinning the exact resolved version on npm and Cargo. (Homebrew users can also run brew upgrade lpm; npm users can use npm install -g @lpm-registry/cli@latest for the channel-latest dist-tag.)

Uninstalling

# npm
npm uninstall -g @lpm-registry/cli

# Homebrew
brew uninstall lpm && brew untap lpm-dev/lpm

# Standalone
rm -rf ~/.lpm/bin/lpm
# Optional: also remove the global store and caches
rm -rf ~/.lpm

~/.lpm/ holds the global content-addressable store, caches, and config. Removing it is safe — LPM will recreate what it needs on the next install.

What got installed

See Reference → Configuration for what lives where.

Next