Installation

Install the CLI

Choose your preferred package manager:

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

# yarn
yarn global add @lpm-registry/cli

# pnpm
pnpm add -g @lpm-registry/cli

# bun
bun add -g @lpm-registry/cli

Once installed, the lpm command is available globally.

Try without installing

You can run any lpm command without a global install using npx:

npx @lpm-registry/cli@latest <command>

This is handy for one-off commands or checking the latest version before committing to a global install. For day-to-day use, the global install is recommended so you get the lpm command directly.

Configure Your Project

Step 1 — Sign in

lpm login

This authenticates with LPM and stores your token securely in the OS keychain.

Step 2 — Configure npm

lpm npmrc

This generates a 30-day read-only token and writes it to your project's .npmrc, so both lpm install and npm install work. It also adds .npmrc to .gitignore automatically.

Run lpm npmrc again when the token expires.

Step 3 — Install packages

npm install @lpm.dev/owner.package-name

Or use the LPM CLI:

lpm install @lpm.dev/owner.package-name

Verify

lpm doctor

lpm doctor checks:

  • Node.js and npm versions
  • Registry configuration
  • Authentication status
  • Network connectivity to the registry

If anything is misconfigured, it tells you exactly what to fix.

Manual Configuration

If you prefer to configure manually instead of using lpm npmrc, add this to your .npmrc:

@lpm.dev:registry=https://lpm.dev/api/registry

You can place this in your project root (for per-project config) or in ~/.npmrc (for global config).