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

Install

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.

Platform Support

PlatformArchitectureStatus
macOSApple Silicon (arm64)Supported
macOSIntel (x64)Supported
Linuxx64Supported
Linuxarm64Supported
Windowsx64Experimental

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