Install lpm

macOS#

macOS 12 or later, on Apple Silicon or Intel. The builds are signed and notarized by Apple. On an Intel Mac the file is lpm-desktop-macos-amd64.dmg.

1. 1

   Open lpm-desktop-macos-arm64.dmg from your Downloads folder.

2. 2

   Drag lpm into Applications.

3. 3

   Open lpm from Applications. macOS asks once whether to open an app from the internet: choose Open.

4. 4

   Click + in the sidebar and pick a project folder. lpm finds the dev servers in it.

Windows#

Windows 11, x64. The Windows build is a beta and isn’t code-signed yet.

1. 1

   Run lpm-desktop-windows-amd64-setup.exe. It installs for your user, with no admin rights.

2. 2

   If SmartScreen says Windows protected your PC, choose More info, then Run anyway. The beta isn't code-signed yet.

3. 3

   lpm runs commands through Git Bash, so install Git for Windows if you don't have it. Get Git for Windows

4. 4

   Open lpm from the Start menu. Click + in the sidebar and pick a project folder. lpm finds the dev servers in it.

Linux#

64-bit x86, Ubuntu 22.04 or newer (glibc 2.35 or newer). The Linux builds are a beta and aren’t code-signed yet. Pick one of three:

Debian and Ubuntu (.deb)#

1. 1

   Install the package:

   sudo apt install ~/Downloads/lpm-desktop-linux-amd64.deb
2. 2

   Open lpm from your app menu. Click + in the sidebar and pick a project folder. lpm finds the dev servers in it.

Fedora and other rpm systems (.rpm)#

1. 1

   Install the package:

   sudo dnf install ~/Downloads/lpm-desktop-linux-amd64.rpm
2. 2

   Open lpm from your app menu. Click + in the sidebar and pick a project folder. lpm finds the dev servers in it.

Any distribution (AppImage)#

1. 1

   Unlike the packages, the AppImage doesn't bring its tools along: install Git, SSH and wl-clipboard or xclip if you don't have them.

2. 2

   Make it executable:

   chmod +x ~/Downloads/lpm-desktop-linux-amd64.AppImage
3. 3

   Run it:

   ~/Downloads/lpm-desktop-linux-amd64.AppImage
4. 4

   Click + in the sidebar and pick a project folder. lpm finds the dev servers in it.

Your first project#

Click + in the sidebar and pick a folder, or paste a Git URL to clone one. lpm reads the project’s own files and writes a service for each dev server it finds (see service detection). Press Start to run them all, then open Claude Code or Codex from the project toolbar. To let your agent change the setup for you, install the lpm skills and CLI.

Updates#

lpm checks GitHub for a new version at launch and every 24 hours, and offers it in the sidebar. On a Mac, Update installs it and restarts lpm, or waits until your agents finish. On Windows and Linux, Download opens the release, and you install it the way you installed lpm. Settings → Updates switches between the Stable and Beta channels.

Check what you downloaded#

Every build has a SHA-256 checksum, and the Mac builds can be checked against Apple’s notarization. Security has the commands, the checksums for the latest release, and what lpm sends over the network.

If it won’t install or open#

• “lpm” is not supported on this Mac

  The build doesn’t match your Mac’s chip. Apple menu → About This Mac shows the chip: Apple M-series needs the Apple Silicon build, Intel needs the Intel one.

• Windows protected your PC

  SmartScreen warns about apps that aren’t code-signed. Choose More info, then Run anyway.

• Commands fail on Windows

  lpm runs commands through Git Bash. Install Git for Windows, then restart lpm.

• The Linux package won’t install or start

  The builds need glibc 2.35 or newer (Ubuntu 22.04 or later) on 64-bit x86. There’s no ARM build yet.

• Something else

  Ask in GitHub Discussions or on Telegram, or open an issue with your OS version and what you see.

Remove lpm#