Installation

Install the LeadMagic CLI on macOS, Linux, or Windows

Install the LeadMagic CLI in one command. The installer downloads a self-contained binary with a bundled runtime — no additional dependencies required.

Install

macOS / Linux

curl -fsSL https://releases.leadmagic.io/install.sh | bash

The installer:

• Downloads the correct binary for your platform and architecture
• Installs to ~/.leadmagic/bin/lm
• Adds ~/.leadmagic/bin to your PATH (updates your shell profile)
• Runs lm welcome to confirm the install

Open a new terminal or run source ~/.zshrc (or ~/.bashrc) after install for the PATH update to take effect.

Windows

irm https://releases.leadmagic.io/install.ps1 | iex

The installer downloads the binary and adds it to your PATH.

Windows support is experimental. The installer downloads the Linux binary and rebuilds native modules locally, which requires additional tooling.

Direct Download

Download a tarball directly from the releases server:

# Latest version
curl -O https://releases.leadmagic.io/latest/lm-darwin-arm64.tar.gz

# Specific version
curl -O https://releases.leadmagic.io/v2.1.16/lm-v2.1.16-darwin-arm64.tar.gz

Extract and move to your PATH:

tar -xzf lm-darwin-arm64.tar.gz
mv lm ~/.leadmagic/bin/lm
chmod +x ~/.leadmagic/bin/lm

Checksums are available for verification:

curl -O https://releases.leadmagic.io/latest/checksums.txt
sha256sum -c checksums.txt

Platform Support

Platform	Architecture	Status
macOS	Apple Silicon (arm64)	Supported
macOS	Intel (x64)	Supported
Linux	x64	Supported
Linux	arm64	Supported
Windows	x64	Experimental

Version Pinning

Install a specific version by setting the VERSION environment variable:

VERSION=2.1.16 curl -fsSL https://releases.leadmagic.io/install.sh | bash

Change the install directory with LEADMAGIC_INSTALL_DIR:

LEADMAGIC_INSTALL_DIR=/opt/leadmagic curl -fsSL https://releases.leadmagic.io/install.sh | bash

Verify Installation

Run the health check to confirm everything is working:

lm doctor

If issues are found, auto-repair with:

lm doctor --fix

Use --verbose for detailed diagnostic output:

lm doctor --verbose

Shell Completions

Enable tab completions for your shell:

lm completions install

Supports bash, zsh, and fish. The shell is auto-detected, or specify it explicitly:

lm completions install --shell zsh

Remove completions with:

lm completions uninstall

Update

The CLI checks for updates automatically and shows a one-line notice when a newer version is available.

To update manually:

lm update

To check for updates without installing:

lm update --check

Uninstall

Remove the CLI and all associated files:

curl -fsSL https://releases.leadmagic.io/install.sh | bash -s -- --uninstall

This removes the binary and the ~/.leadmagic/bin directory. Your data (config, database, exports) in ~/.leadmagic/ is preserved. Delete that directory manually if you want a complete removal.

Next Steps

Authentication

Sign in with browser OAuth.

Quickstart

Your first enrichment workflow in 5 minutes.