@lpm-registry/cli 0.2.4 → 0.2.6

package/CHANGELOG.md

@@ -2,6 +2,39 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.2.6] - 2026-03-21
+
+### Added
+
+- **`lpm uninstall` command** — Mirrors `npm uninstall` with automatic registry auth. Aliases: `lpm un`, `lpm unlink`.
+- **`--pm` flag for install/uninstall** — Choose package manager: `lpm install --pm pnpm`. Supports npm (default), pnpm, yarn, bun.
+- **`lpm config set packageManager`** — Set default package manager globally. Also available via `LPM_PACKAGE_MANAGER` env var.
+
+### Changed
+
+- `lpm install` now shows package list before install: "Found 15 LPM packages in package.json"
+- Skills install now scoped to explicit packages when specified (`lpm install @lpm.dev/pkg` only fetches skills for that package)
+- Skills install skips `file:`, `link:`, `workspace:` dependencies (local packages)
+- `lpm doctor` registry check fixed — uses `/-/whoami` endpoint instead of non-existent `/health`
+- Publish script updated with version bumping, git commit/tag/push, and `--dry-run` support
+
+### Fixed
+
+- pnpm/yarn/bun compatibility — no longer passes npm-specific `--userconfig` flag. Uses project `.npmrc` with backup/restore for non-npm package managers.
+
+## [0.2.5] - 2026-03-19
+
+### Added
+
+- **`lpm npmrc` command** — Generates a 30-day read-only token and writes it to `.npmrc` for local development. Auto-adds `.npmrc` to `.gitignore`. Makes `npm install` work without env vars or manual token setup.
+- **`lpm setup --oidc` flag** — Exchanges CI OIDC token (GitHub Actions, GitLab CI) for a short-lived read-only install token. Eliminates static `LPM_TOKEN` secrets in CI. Falls back to `${LPM_TOKEN}` placeholder if OIDC is unavailable.
+- **OIDC read scope support** — Server-side OIDC token exchange now accepts `?scope=read` for install-only tokens (30 min TTL). Uses Supabase OAuth identity linking instead of trusted publisher config.
+
+### Changed
+
+- OIDC module refactored for reuse — `exchangeOidcInstallToken()` auto-detects CI environment and exchanges for read-only tokens
+- `lpm setup` default mode now mentions `lpm npmrc` and `--oidc` in help output
+
 ## [0.2.4] - 2026-03-18
 
 ### Added

package/README.md

@@ -65,23 +65,28 @@ lpm whoami
 
 ### Project Setup
 
-#### Setup .npmrc
+#### Generate .npmrc Token (Local Dev)
 
-Configure your project's `.npmrc` for LPM packages. Required for CI/CD deployments.
+Generate a 30-day read-only token for your project. Makes `npm install` work with LPM packages.
 
 ```bash
-lpm setup
+lpm npmrc                  # 30-day token (default)
+lpm npmrc --days 7         # 7-day token
+lpm npmrc --days 90        # 90-day token
 ```
 
-This creates a `.npmrc` file with the LPM registry configuration:
+Automatically adds `.npmrc` to `.gitignore` to prevent token leaks.
 
-```ini
-# LPM Registry
-@lpm.dev:registry=https://lpm.dev/api/registry
-//lpm.dev/api/registry/:_authToken=${LPM_TOKEN}
+#### Setup .npmrc (CI/CD)
+
+Configure `.npmrc` for CI/CD environments.
+
+```bash
+lpm setup                  # Writes ${LPM_TOKEN} placeholder
+lpm setup --oidc           # OIDC — no secrets needed (GitHub Actions, GitLab CI)
 ```
 
-For deployment, set the `LPM_TOKEN` environment variable on your platform (Vercel, Netlify, etc.).
+For deployment platforms (Vercel, Netlify), set the `LPM_TOKEN` environment variable.
 
 ### Package Management
 
@@ -120,6 +125,7 @@ lpm install @lpm.dev/owner.package-name
 lpm install @lpm.dev/tolgaergin.utils @lpm.dev/acme.helpers
 lpm install                 # Install all @lpm.dev packages from package.json
 lpm install --no-skills     # Skip fetching Agent Skills
+lpm install --pm pnpm       # Use pnpm instead of npm
 lpm i                       # Shortcut
 ```
 
@@ -128,6 +134,19 @@ Agent Skills are fetched by default for packages that include them.
 | Option        | Description                              |
 | ------------- | ---------------------------------------- |
 | `--no-skills` | Skip fetching Agent Skills after install |
+| `--pm <name>` | Package manager: npm (default), pnpm, yarn, bun |
+
+Set a default package manager: `lpm config set packageManager pnpm`
+
+#### Uninstall
+
+Uninstall packages with automatic registry authentication.
+
+```bash
+lpm uninstall @lpm.dev/owner.package-name
+lpm uninstall --pm pnpm     # Use pnpm
+lpm un                      # Shortcut
+```
 
 #### Add (Source Code)
 

package/bin/lpm.js

@@ -19,6 +19,7 @@ import { logout } from "../lib/commands/logout.js"
 import { marketplaceCompare } from "../lib/commands/marketplace-compare.js"
 import { marketplaceEarnings } from "../lib/commands/marketplace-earnings.js"
 import { mcpRemove, mcpSetup, mcpStatus } from "../lib/commands/mcp-setup.js"
+import { npmrc } from "../lib/commands/npmrc.js"
 import { openDashboard } from "../lib/commands/open.js"
 import { outdated } from "../lib/commands/outdated.js"
 import { poolStats } from "../lib/commands/pool-stats.js"
@@ -35,6 +36,7 @@ import {
 	skillsValidate,
 } from "../lib/commands/skills.js"
 import { rotateToken } from "../lib/commands/token-rotate.js"
+import { uninstall } from "../lib/commands/uninstall.js"
 import { whoami } from "../lib/commands/whoami.js"
 
 // Load package.json
@@ -92,8 +94,16 @@ program
 	.description("Install packages with automatic registry authentication")
 	.option("--json", "Machine-readable JSON output")
 	.option("--no-skills", "Skip fetching Agent Skills after install")
+	.option("--pm <manager>", "Package manager to use (npm, pnpm, yarn, bun)")
 	.action(install)
 
+program
+	.command("uninstall <packages...>")
+	.aliases(["un", "unlink"])
+	.description("Uninstall packages via package manager")
+	.option("--pm <manager>", "Package manager to use (npm, pnpm, yarn, bun)")
+	.action(uninstall)
+
 program
 	.command("publish")
 	.alias("p")
@@ -202,8 +212,18 @@ program
 	.command("setup")
 	.description("Configure .npmrc for LPM packages (@lpm.dev scope)")
 	.option("-r, --registry <url>", "Custom registry URL")
+	.option(
+		"--oidc",
+		"Exchange CI OIDC token for install access (no secrets needed)",
+	)
 	.action(setup)
 
+program
+	.command("npmrc")
+	.description("Generate a read-only .npmrc token for local development")
+	.option("-d, --days <number>", "Token expiry in days (default: 30)")
+	.action(npmrc)
+
 program
 	.command("config [action] [key] [value]")
 	.description("Manage CLI configuration (list, get, set, delete)")

package/lib/commands/doctor.js

@@ -24,16 +24,14 @@ export async function doctor() {
 	// 2. Check Registry Reachability
 	const spinnerApi = createSpinner("Checking registry connection...").start()
 	try {
-		// Assuming we have a health endpoint or similar. Using the registry URL from config or default.
 		const registryUrl = getRegistryUrl()
-		const res = await fetch(`${registryUrl}/api/registry/health`)
-		if (res.ok) {
-			spinnerApi.succeed(`Registry reachable at ${registryUrl}`)
-			checks.push({ name: "Registry API", status: "ok" })
-		} else {
-			spinnerApi.fail(`Registry returned status ${res.status}`)
-			checks.push({ name: "Registry API", status: "fail" })
-		}
+		// Use /-/whoami without a token — a 401 "Missing token" proves the registry is reachable.
+		// Only network errors (ECONNREFUSED, timeout) indicate the registry is down.
+		await fetch(`${registryUrl}/api/registry/-/whoami`, {
+			signal: AbortSignal.timeout(10000),
+		})
+		spinnerApi.succeed(`Registry reachable at ${registryUrl}`)
+		checks.push({ name: "Registry API", status: "ok" })
 	} catch (err) {
 		spinnerApi.fail(`Could not connect to registry: ${err.message}`)
 		checks.push({ name: "Registry API", status: "fail" })

package/lib/commands/install.js

@@ -1,7 +1,7 @@
 import { spawn } from "node:child_process"
 import fs from "node:fs"
 import path from "node:path"
-import { getRegistryUrl, getToken } from "../config.js"
+import { getPackageManager, getRegistryUrl, getToken } from "../config.js"
 import { createSpinner, log, printHeader } from "../ui.js"
 import { skillsInstall } from "./skills.js"
 
@@ -44,6 +44,9 @@ export async function install(packages, options) {
 		process.exit(1)
 	}
 
+	// Track if user specified packages explicitly (for scoped skills fetch)
+	const explicitPackages = packages && packages.length > 0
+
 	if (!packages || packages.length === 0) {
 		// No packages specified - read from package.json
 		const packageJsonPath = path.resolve(process.cwd(), "package.json")
@@ -99,17 +102,16 @@ export async function install(packages, options) {
 		}
 
 		if (!isJson) {
-			log.info(
-				`Installing ${packages.length} LPM packages from package.json...`,
-			)
+			log.info(`Found ${packages.length} LPM packages in package.json:`)
+			for (const pkg of packages) {
+				log.info(`  ${pkg}`)
+			}
 		}
 	}
 
 	let spinner
 	if (!isJson) {
-		spinner = createSpinner(
-			`Preparing to install ${packages.join(", ")}...`,
-		).start()
+		spinner = createSpinner("Configuring registry authentication...").start()
 	}
 
 	const baseRegistryUrl = getRegistryUrl()
@@ -126,26 +128,54 @@ export async function install(packages, options) {
 @lpm.dev:registry=${registryUrl}
 `
 
-	// Write to temp file
-	const tempNpmrcPath = path.resolve(process.cwd(), `.npmrc.lpm-${Date.now()}`)
-	fs.writeFileSync(tempNpmrcPath, npmrcContent)
+	const pm = getPackageManager(options?.pm)
+
+	// For npm we can use --userconfig with a temp file.
+	// For pnpm/yarn/bun we write a temporary project .npmrc (all PMs read it).
+	const projectNpmrcPath = path.resolve(process.cwd(), ".npmrc")
+	let existingNpmrc = null
+	let tempNpmrcPath = null
+
+	if (pm === "npm") {
+		// npm supports --userconfig — use a separate temp file (doesn't touch project .npmrc)
+		tempNpmrcPath = path.resolve(process.cwd(), `.npmrc.lpm-${Date.now()}`)
+		fs.writeFileSync(tempNpmrcPath, npmrcContent)
+	} else {
+		// pnpm/yarn/bun read project .npmrc — back up existing, write temp, restore after
+		if (fs.existsSync(projectNpmrcPath)) {
+			existingNpmrc = fs.readFileSync(projectNpmrcPath, "utf8")
+		}
+		fs.writeFileSync(projectNpmrcPath, npmrcContent)
+	}
 
 	if (!isJson) {
-		spinner.succeed("Configuration generated. Running npm install...")
+		spinner.succeed(`Configuration generated. Running ${pm} install...`)
 	}
 
-	// Run npm install
-	const npmArgs = ["install", ...packages, "--userconfig", tempNpmrcPath]
+	const pmArgs =
+		pm === "npm"
+			? ["install", ...packages, "--userconfig", tempNpmrcPath]
+			: ["install", ...packages]
 
 	// In JSON mode, capture stdout/stderr instead of inheriting
-	const child = spawn("npm", npmArgs, {
+	const child = spawn(pm, pmArgs, {
 		stdio: isJson ? "pipe" : "inherit",
 		env: { ...process.env, LPM_TOKEN: token },
 	})
 
 	const cleanup = () => {
-		if (fs.existsSync(tempNpmrcPath)) {
-			fs.unlinkSync(tempNpmrcPath)
+		if (pm === "npm") {
+			// Remove temp file
+			if (tempNpmrcPath && fs.existsSync(tempNpmrcPath)) {
+				fs.unlinkSync(tempNpmrcPath)
+			}
+		} else {
+			// Restore original .npmrc (or remove if there wasn't one)
+			if (existingNpmrc !== null) {
+				fs.writeFileSync(projectNpmrcPath, existingNpmrc)
+			} else if (fs.existsSync(projectNpmrcPath)) {
+				fs.unlinkSync(projectNpmrcPath)
+			}
 		}
 	}
 
@@ -168,11 +198,19 @@ export async function install(packages, options) {
 				packages: packages.map(p => ({ name: p })),
 				npmOutput: (stdout + stderr).trim(),
 				warnings: [],
-				errors: code !== 0 ? [`npm install failed with code ${code}`] : [],
+				errors: code !== 0 ? [`${pm} install failed with code ${code}`] : [],
 			}
 			process.stdout.write(`${JSON.stringify(output, null, 2)}\n`)
 			if (code !== 0) process.exit(code)
-			if (fetchSkills) await skillsInstall(null, { json: true })
+			if (fetchSkills) {
+				if (explicitPackages) {
+					for (const pkg of packages.filter(isLpmPackage)) {
+						await skillsInstall(pkg, { json: true })
+					}
+				} else {
+					await skillsInstall(null, { json: true })
+				}
+			}
 		})
 
 		child.on("error", err => {
@@ -182,7 +220,7 @@ export async function install(packages, options) {
 				packages: packages.map(p => ({ name: p })),
 				npmOutput: "",
 				warnings: [],
-				errors: [`Failed to start npm: ${err.message}`],
+				errors: [`Failed to start ${pm}: ${err.message}`],
 			}
 			process.stdout.write(`${JSON.stringify(output, null, 2)}\n`)
 			process.exit(1)
@@ -191,19 +229,25 @@ export async function install(packages, options) {
 		child.on("close", async code => {
 			cleanup()
 			if (code !== 0) {
-				log.error(`npm install failed with code ${code}`)
+				log.error(`${pm} install failed with code ${code}`)
 				process.exit(code)
 			} else {
 				log.success("Packages installed successfully.")
 				if (fetchSkills) {
 					console.log("")
-					await skillsInstall(null)
+					if (explicitPackages) {
+						for (const pkg of packages.filter(isLpmPackage)) {
+							await skillsInstall(pkg)
+						}
+					} else {
+						await skillsInstall(null)
+					}
 				}
 			}
 		})
 
 		child.on("error", err => {
-			log.error(`Failed to start npm: ${err.message}`)
+			log.error(`Failed to start ${pm}: ${err.message}`)
 			cleanup()
 			process.exit(1)
 		})

package/lib/commands/npmrc.js

@@ -0,0 +1,140 @@
+import fs from "node:fs"
+import path from "node:path"
+import { request } from "../api.js"
+import { getRegistryUrl, getToken } from "../config.js"
+import { createSpinner, log, printHeader } from "../ui.js"
+
+/**
+ * Generate a read-only .npmrc token for local development.
+ * Creates a 30-day scoped token and writes it to the project's .npmrc.
+ * Also ensures .npmrc is in .gitignore to prevent accidental commits.
+ */
+export async function npmrc(options) {
+	printHeader()
+
+	const token = await getToken()
+	if (!token) {
+		log.error(
+			'You must be logged in to generate an .npmrc token. Run "lpm login" first.',
+		)
+		process.exit(1)
+	}
+
+	const projectRoot = process.cwd()
+	const npmrcPath = path.join(projectRoot, ".npmrc")
+	const gitignorePath = path.join(projectRoot, ".gitignore")
+
+	// Check for package.json
+	const pkgJsonPath = path.join(projectRoot, "package.json")
+	if (!fs.existsSync(pkgJsonPath)) {
+		log.warn("No package.json found. Run this command in your project root.")
+	}
+
+	// Derive project name for the token label
+	let projectName = "project"
+	if (fs.existsSync(pkgJsonPath)) {
+		try {
+			const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf8"))
+			if (pkg.name) {
+				projectName = pkg.name.replace(/[^a-zA-Z0-9._-]/g, "-")
+			}
+		} catch {
+			// Invalid package.json — use default name
+		}
+	}
+
+	const expiryDays = parseInt(options?.days, 10) || 30
+	const spinner = createSpinner("Creating read-only token...").start()
+
+	// Call server to create a scoped read-only token
+	let readToken
+	let expiresAt
+	try {
+		const tokenName = `npmrc-${projectName}-${new Date().toISOString().slice(0, 10)}`
+		const response = await request("/-/token/create", {
+			method: "POST",
+			body: JSON.stringify({
+				scope: "read",
+				name: tokenName,
+				expiryDays,
+			}),
+			headers: { "Content-Type": "application/json" },
+		})
+
+		if (!response.ok) {
+			const text = await response.text()
+			throw new Error(`Token creation failed: ${response.status} ${text}`)
+		}
+
+		const data = await response.json()
+		readToken = data.token
+		expiresAt = data.expiresAt
+		spinner.succeed("Read-only token created.")
+	} catch (error) {
+		spinner.fail(`Failed to create token: ${error.message}`)
+		process.exit(1)
+	}
+
+	// Build .npmrc content
+	const registryUrl = getRegistryUrl()
+	const fullRegistryUrl = registryUrl.endsWith("/api/registry")
+		? registryUrl
+		: `${registryUrl}/api/registry`
+	const registryHost = fullRegistryUrl.replace(/^https?:/, "")
+
+	// Read existing .npmrc and remove old LPM config lines
+	let npmrcContent = ""
+	if (fs.existsSync(npmrcPath)) {
+		npmrcContent = fs
+			.readFileSync(npmrcPath, "utf8")
+			.split("\n")
+			.filter(line => {
+				return (
+					!line.includes("@lpm.dev:registry") &&
+					!line.includes("lpm.dev/api/registry/:_authToken") &&
+					!line.includes("_authToken=lpm_") &&
+					// biome-ignore lint/suspicious/noTemplateCurlyInString: matching literal npm token placeholder
+					!line.includes("_authToken=${LPM_TOKEN}") &&
+					!line.includes("# LPM Registry")
+				)
+			})
+			.join("\n")
+			.trim()
+	}
+
+	const lpmConfig = `# LPM Registry (generated by lpm npmrc — do not commit)
+@lpm.dev:registry=${fullRegistryUrl}
+${registryHost}/:_authToken=${readToken}`
+
+	npmrcContent = npmrcContent ? `${npmrcContent}\n\n${lpmConfig}` : lpmConfig
+	fs.writeFileSync(npmrcPath, `${npmrcContent}\n`)
+
+	// Ensure .npmrc is in .gitignore
+	let gitignoreUpdated = false
+	if (fs.existsSync(gitignorePath)) {
+		const gitignore = fs.readFileSync(gitignorePath, "utf8")
+		if (!gitignore.split("\n").some(line => line.trim() === ".npmrc")) {
+			fs.writeFileSync(gitignorePath, `${gitignore.trimEnd()}\n.npmrc\n`)
+			gitignoreUpdated = true
+		}
+	} else {
+		fs.writeFileSync(gitignorePath, ".npmrc\n")
+		gitignoreUpdated = true
+	}
+
+	// Output
+	console.log("")
+	log.success(".npmrc configured with read-only LPM token.")
+	if (gitignoreUpdated) {
+		log.info(".npmrc added to .gitignore to prevent token leaks.")
+	}
+
+	const expiryDate = new Date(expiresAt).toLocaleDateString("en-US", {
+		year: "numeric",
+		month: "long",
+		day: "numeric",
+	})
+	log.info(`Token expires: ${expiryDate}`)
+	log.info("Run `lpm npmrc` again to refresh when expired.")
+	console.log("")
+}

package/lib/commands/setup.js

@@ -3,11 +3,36 @@ import path from "node:path"
 import * as p from "@clack/prompts"
 import chalk from "chalk"
 import { getRegistryUrl } from "../config.js"
+import { exchangeOidcInstallToken } from "../oidc.js"
 import { log, printHeader } from "../ui.js"
 
+/**
+ * Remove existing LPM config lines from .npmrc content.
+ * @param {string} content
+ * @returns {string}
+ */
+function removeLpmLines(content) {
+	return content
+		.split("\n")
+		.filter(line => {
+			return (
+				!line.includes("@lpm.dev:registry") &&
+				!line.includes("lpm.dev/api/registry/:_authToken") &&
+				!line.includes("_authToken=lpm_") &&
+				// biome-ignore lint/suspicious/noTemplateCurlyInString: matching literal npm token placeholder
+				!line.includes("_authToken=${LPM_TOKEN}") &&
+				!line.includes("# LPM Registry")
+			)
+		})
+		.join("\n")
+		.trim()
+}
+
 /**
  * Configure .npmrc for LPM packages.
- * Sets up the @lpm.dev scope to point to the LPM registry.
+ *
+ * Default mode: writes ${LPM_TOKEN} placeholder (for CI with env var).
+ * --oidc mode: exchanges CI OIDC token for a real short-lived token (no secrets needed).
  */
 export async function setup(options) {
 	printHeader()
@@ -24,6 +49,56 @@ export async function setup(options) {
 		log.warn("No package.json found. Run this command in your project root.")
 	}
 
+	// Build registry URL
+	const fullRegistryUrl = registryUrl.endsWith("/api/registry")
+		? registryUrl
+		: `${registryUrl}/api/registry`
+	const registryHost = fullRegistryUrl.replace(/^https?:/, "")
+
+	// ── OIDC mode: exchange CI token for a real short-lived install token ──
+	if (options?.oidc) {
+		let oidcToken
+		try {
+			oidcToken = await exchangeOidcInstallToken()
+		} catch (err) {
+			log.warn(`OIDC exchange failed: ${err.message}`)
+			// biome-ignore lint/suspicious/noTemplateCurlyInString: literal placeholder name in user-facing message
+			log.warn("Falling back to ${LPM_TOKEN} environment variable placeholder.")
+			// Fall through to default mode
+		}
+
+		if (oidcToken) {
+			let npmrcContent = ""
+			if (fs.existsSync(npmrcPath)) {
+				npmrcContent = removeLpmLines(fs.readFileSync(npmrcPath, "utf8"))
+			}
+
+			const lpmConfig = `# LPM Registry (OIDC — expires in 30 minutes)
+@lpm.dev:registry=${fullRegistryUrl}
+${registryHost}/:_authToken=${oidcToken}`
+
+			npmrcContent = npmrcContent
+				? `${npmrcContent}\n\n${lpmConfig}`
+				: lpmConfig
+			fs.writeFileSync(npmrcPath, `${npmrcContent}\n`)
+
+			p.note(
+				`@lpm.dev:registry=${fullRegistryUrl}\nToken: OIDC read-only (30 min)`,
+				".npmrc configuration",
+			)
+
+			console.log("")
+			log.success(".npmrc configured with OIDC read-only token.")
+			log.info("Token expires in 30 minutes. No LPM_TOKEN secret needed.")
+			console.log("")
+
+			p.outro("Setup complete!")
+			return
+		}
+	}
+
+	// ── Default mode: ${LPM_TOKEN} placeholder ──
+
 	// Check for existing .npmrc
 	let npmrcContent = ""
 	if (fs.existsSync(npmrcPath)) {
@@ -41,40 +116,18 @@ export async function setup(options) {
 				return
 			}
 
-			// Remove existing LPM config lines
-			npmrcContent = npmrcContent
-				.split("\n")
-				.filter(line => {
-					return (
-						!line.includes("@lpm.dev:registry") &&
-						!line.includes("lpm.dev/api/registry/:_authToken") &&
-						!line.includes("# LPM Registry")
-					)
-				})
-				.join("\n")
-				.trim()
+			npmrcContent = removeLpmLines(npmrcContent)
 		}
 	}
 
-	// Build registry URL
-	const fullRegistryUrl = registryUrl.endsWith("/api/registry")
-		? registryUrl
-		: `${registryUrl}/api/registry`
-
-	// Remove protocol for auth token config
-	const registryHost = fullRegistryUrl.replace(/^https?:/, "")
-
-	// Add LPM registry config
+	// Add LPM registry config with placeholder
 	const lpmConfig = `
 # LPM Registry
 @lpm.dev:registry=${fullRegistryUrl}
 ${registryHost}/:_authToken=\${LPM_TOKEN}
 `.trim()
 
-	// Combine with existing content
 	npmrcContent = npmrcContent ? `${npmrcContent}\n\n${lpmConfig}` : lpmConfig
-
-	// Write .npmrc
 	fs.writeFileSync(npmrcPath, `${npmrcContent}\n`)
 
 	p.note(
@@ -84,8 +137,9 @@ ${registryHost}/:_authToken=\${LPM_TOKEN}
 
 	console.log("")
 	log.success(".npmrc configured for LPM packages.")
-	log.info("For local development: Run `lpm login` to authenticate.")
+	log.info("For local development: Run `lpm npmrc` to generate a token.")
 	log.info("For CI/CD: Set the LPM_TOKEN environment variable.")
+	log.info("For CI/CD with OIDC: Run `lpm setup --oidc` (no secrets needed).")
 	console.log("")
 
 	p.outro("Setup complete!")

package/lib/commands/skills.js

@@ -322,7 +322,18 @@ function getLpmDependencies() {
 	const allDeps = { ...pkg.dependencies, ...pkg.devDependencies }
 
 	return Object.entries(allDeps)
-		.filter(([name]) => name.startsWith("@lpm.dev/"))
+		.filter(([name, version]) => {
+			if (!name.startsWith("@lpm.dev/")) return false
+			// Skip local file/link references — they have their own .lpm/skills/
+			if (
+				version.startsWith("file:") ||
+				version.startsWith("link:") ||
+				version.startsWith("workspace:")
+			) {
+				return false
+			}
+			return true
+		})
 		.map(([name, version]) => ({
 			fullName: name,
 			shortName: name.replace("@lpm.dev/", ""),

package/lib/commands/uninstall.js

@@ -0,0 +1,107 @@
+import { spawn } from "node:child_process"
+import fs from "node:fs"
+import path from "node:path"
+import { getPackageManager, getRegistryUrl, getToken } from "../config.js"
+import { createSpinner, log, printHeader } from "../ui.js"
+
+/**
+ * Uninstall LPM packages.
+ * Creates a temporary .npmrc with auth, runs the package manager's uninstall, and cleans up.
+ *
+ * @param {string[]} packages - Package names to uninstall
+ * @param {object} [options]
+ * @param {string} [options.pm] - Package manager override (npm, pnpm, yarn, bun)
+ */
+export async function uninstall(packages, options) {
+	printHeader()
+
+	if (!packages || packages.length === 0) {
+		log.error("Please specify at least one package to uninstall.")
+		log.info("Usage: lpm uninstall @lpm.dev/owner.package-name")
+		process.exit(1)
+	}
+
+	const token = await getToken()
+	if (!token) {
+		log.error(
+			'You must be logged in to uninstall packages. Run "lpm login" first.',
+		)
+		process.exit(1)
+	}
+
+	const pm = getPackageManager(options?.pm)
+	const spinner = createSpinner(
+		`Preparing to uninstall ${packages.join(", ")}...`,
+	).start()
+
+	const baseRegistryUrl = getRegistryUrl()
+	const registryUrl = baseRegistryUrl.endsWith("/api/registry")
+		? baseRegistryUrl
+		: `${baseRegistryUrl}/api/registry`
+	const registryHost = registryUrl.replace(/^https?:/, "")
+
+	const npmrcContent = `${registryHost}/:_authToken=${token}
+@lpm.dev:registry=${registryUrl}
+`
+
+	const projectNpmrcPath = path.resolve(process.cwd(), ".npmrc")
+	let existingNpmrc = null
+	let tempNpmrcPath = null
+
+	if (pm === "npm") {
+		tempNpmrcPath = path.resolve(process.cwd(), `.npmrc.lpm-${Date.now()}`)
+		fs.writeFileSync(tempNpmrcPath, npmrcContent)
+	} else {
+		if (fs.existsSync(projectNpmrcPath)) {
+			existingNpmrc = fs.readFileSync(projectNpmrcPath, "utf8")
+		}
+		fs.writeFileSync(projectNpmrcPath, npmrcContent)
+	}
+
+	spinner.succeed(`Configuration generated. Running ${pm} uninstall...`)
+
+	const pmArgs =
+		pm === "npm"
+			? ["uninstall", ...packages, "--userconfig", tempNpmrcPath]
+			: ["uninstall", ...packages]
+
+	const child = spawn(pm, pmArgs, {
+		stdio: "inherit",
+		env: { ...process.env, LPM_TOKEN: token },
+	})
+
+	const cleanup = () => {
+		if (pm === "npm") {
+			if (tempNpmrcPath && fs.existsSync(tempNpmrcPath)) {
+				fs.unlinkSync(tempNpmrcPath)
+			}
+		} else {
+			if (existingNpmrc !== null) {
+				fs.writeFileSync(projectNpmrcPath, existingNpmrc)
+			} else if (fs.existsSync(projectNpmrcPath)) {
+				fs.unlinkSync(projectNpmrcPath)
+			}
+		}
+	}
+
+	child.on("close", code => {
+		cleanup()
+		if (code !== 0) {
+			log.error(`${pm} uninstall failed with code ${code}`)
+			process.exit(code)
+		} else {
+			log.success("Packages uninstalled successfully.")
+		}
+	})
+
+	child.on("error", err => {
+		log.error(`Failed to start ${pm}: ${err.message}`)
+		cleanup()
+		process.exit(1)
+	})
+
+	process.on("SIGINT", () => {
+		cleanup()
+		process.exit()
+	})
+}

package/lib/config.js

@@ -183,6 +183,32 @@ export function setRetries(count) {
 	config.set("retries", count)
 }
 
+// ============================================================================
+// Package Manager Configuration
+// ============================================================================
+
+const VALID_PACKAGE_MANAGERS = new Set(["npm", "pnpm", "yarn", "bun"])
+const DEFAULT_PACKAGE_MANAGER = "npm"
+
+/**
+ * Get the configured package manager for install/uninstall operations.
+ * Priority: --pm flag > LPM_PACKAGE_MANAGER env > config > "npm"
+ * @param {string} [override] - CLI flag override (--pm value)
+ * @returns {string}
+ */
+export function getPackageManager(override) {
+	const pm =
+		override ||
+		process.env.LPM_PACKAGE_MANAGER ||
+		config.get("packageManager", DEFAULT_PACKAGE_MANAGER)
+
+	if (!VALID_PACKAGE_MANAGERS.has(pm)) {
+		return DEFAULT_PACKAGE_MANAGER
+	}
+
+	return pm
+}
+
 // ============================================================================
 // General Configuration Access
 // ============================================================================
@@ -197,6 +223,7 @@ export async function getAllConfig() {
 
 	return {
 		registryUrl: getRegistryUrl(),
+		packageManager: getPackageManager(),
 		timeout: getTimeout(),
 		retries: getRetries(),
 		secureStorage: usingKeychain ? "keychain" : "encrypted-file",
@@ -213,6 +240,7 @@ export function getConfigValue(key) {
 	const configMap = {
 		registry: getRegistryUrl,
 		registryUrl: getRegistryUrl,
+		packageManager: getPackageManager,
 		timeout: getTimeout,
 		retries: getRetries,
 	}
@@ -232,6 +260,15 @@ export function setConfigValue(key, value) {
 	const configMap = {
 		registry: setRegistryUrl,
 		registryUrl: setRegistryUrl,
+		packageManager: val => {
+			if (VALID_PACKAGE_MANAGERS.has(val)) {
+				config.set("packageManager", val)
+			} else {
+				throw new Error(
+					`Invalid package manager "${val}". Valid options: ${[...VALID_PACKAGE_MANAGERS].join(", ")}`,
+				)
+			}
+		},
 		timeout: val => setTimeout(Number(val)),
 		retries: val => setRetries(Number(val)),
 	}

package/lib/oidc.js

@@ -1,12 +1,13 @@
 /**
- * OIDC (OpenID Connect) token exchange for secret-free publishing.
+ * OIDC (OpenID Connect) token exchange for secret-free CI operations.
  *
  * When running in GitHub Actions with `id-token: write` permission,
  * this module requests an OIDC JWT from GitHub and exchanges it for
- * a short-lived LPM publish token — no LPM_TOKEN secret required.
+ * a short-lived LPM token — no LPM_TOKEN secret required.
  *
- * The package must have a matching trusted publisher configured in
- * the LPM dashboard (Workflow tab) before this will succeed.
+ * Two modes:
+ * - **Publish**: Requires trusted publisher config in LPM dashboard.
+ * - **Read (install)**: Requires GitHub/GitLab account linked to LPM user.
  *
  * @module cli/lib/oidc
  */
@@ -39,20 +40,10 @@ export function isGitLabCiWithOidc() {
 }
 
 /**
- * Exchange a GitHub Actions OIDC JWT for a short-lived LPM publish token.
- *
- * Steps:
- * 1. Request an OIDC JWT from GitHub (audience: https://lpm.dev)
- * 2. POST the JWT to the LPM OIDC token exchange endpoint
- * 3. Return the resulting `lpm_xxx` token (valid for 15 minutes)
- *
- * @param {string} packageName - Full package name, e.g. "@lpm.dev/owner.pkg-name"
- * @returns {Promise<string>} Short-lived LPM publish token
- * @throws {Error} If GitHub OIDC request fails or LPM exchange is rejected
+ * Request a GitHub Actions OIDC JWT.
+ * @returns {Promise<string>} The raw JWT string
  */
-export async function exchangeOidcToken(packageName) {
-	// 1. Request OIDC JWT from GitHub Actions
-	// The audience must match EXPECTED_AUDIENCE in lib/registry/oidc.js on the server
+async function requestGitHubOidcJwt() {
 	const githubTokenUrl = `${process.env.ACTIONS_ID_TOKEN_REQUEST_URL}&audience=https://lpm.dev`
 
 	const githubRes = await fetch(githubTokenUrl, {
@@ -73,40 +64,72 @@ export async function exchangeOidcToken(packageName) {
 		throw new Error("GitHub OIDC response did not contain a token value")
 	}
 
-	// 2. Exchange the OIDC JWT for a short-lived LPM publish token
+	return oidcJwt
+}
+
+/**
+ * Exchange an OIDC JWT with the LPM server for a short-lived token.
+ *
+ * @param {string} oidcJwt - The raw OIDC JWT
+ * @param {{ scope?: "read"|"publish", packageName?: string }} [options]
+ * @returns {Promise<{ token: string, expiresAt: string }>}
+ */
+async function exchangeJwtWithServer(oidcJwt, options = {}) {
+	const { scope = "publish", packageName } = options
 	const registryUrl = getRegistryUrl()
-	const exchangeRes = await fetch(`${registryUrl}/api/registry/-/token/oidc`, {
-		method: "POST",
-		headers: { "Content-Type": "application/json" },
-		body: JSON.stringify({ token: oidcJwt, package: packageName }),
-	})
+	const scopeParam = scope === "read" ? "?scope=read" : ""
+
+	const body = { token: oidcJwt }
+	if (packageName) body.package = packageName
+
+	const exchangeRes = await fetch(
+		`${registryUrl}/api/registry/-/token/oidc${scopeParam}`,
+		{
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(body),
+		},
+	)
 
 	if (!exchangeRes.ok) {
-		const body = await exchangeRes.text().catch(() => "")
+		const text = await exchangeRes.text().catch(() => "")
 		throw new Error(
-			`OIDC token exchange failed (${exchangeRes.status})${body ? `: ${body}` : ""}`,
+			`OIDC token exchange failed (${exchangeRes.status})${text ? `: ${text}` : ""}`,
 		)
 	}
 
-	const { token } = await exchangeRes.json()
-	if (!token) {
+	const data = await exchangeRes.json()
+	if (!data.token) {
 		throw new Error("OIDC exchange response did not contain a token")
 	}
 
-	return token
+	return data
 }
 
 /**
- * Exchange a GitLab CI OIDC JWT for a short-lived LPM publish token.
+ * Exchange a GitHub Actions OIDC JWT for a short-lived LPM token.
  *
- * GitLab injects the JWT directly into LPM_GITLAB_OIDC_TOKEN via id_tokens — no
- * intermediate HTTP fetch is needed (unlike GitHub Actions).
+ * @param {string} [packageName] - Required for publish scope, optional for read
+ * @param {{ scope?: "read"|"publish" }} [options]
+ * @returns {Promise<string>} Short-lived LPM token
+ */
+export async function exchangeOidcToken(packageName, options = {}) {
+	const oidcJwt = await requestGitHubOidcJwt()
+	const data = await exchangeJwtWithServer(oidcJwt, {
+		scope: options.scope || "publish",
+		packageName,
+	})
+	return data.token
+}
+
+/**
+ * Exchange a GitLab CI OIDC JWT for a short-lived LPM token.
  *
- * @param {string} packageName - Full package name, e.g. "@lpm.dev/owner.pkg-name"
- * @returns {Promise<string>} Short-lived LPM publish token
- * @throws {Error} If the OIDC token is missing or the LPM exchange is rejected
+ * @param {string} [packageName] - Required for publish scope, optional for read
+ * @param {{ scope?: "read"|"publish" }} [options]
+ * @returns {Promise<string>} Short-lived LPM token
  */
-export async function exchangeGitLabOidcToken(packageName) {
+export async function exchangeGitLabOidcToken(packageName, options = {}) {
 	const oidcJwt = process.env.LPM_GITLAB_OIDC_TOKEN
 	if (!oidcJwt) {
 		throw new Error(
@@ -115,24 +138,29 @@ export async function exchangeGitLabOidcToken(packageName) {
 		)
 	}
 
-	const registryUrl = getRegistryUrl()
-	const exchangeRes = await fetch(`${registryUrl}/api/registry/-/token/oidc`, {
-		method: "POST",
-		headers: { "Content-Type": "application/json" },
-		body: JSON.stringify({ token: oidcJwt, package: packageName }),
+	const data = await exchangeJwtWithServer(oidcJwt, {
+		scope: options.scope || "publish",
+		packageName,
 	})
+	return data.token
+}
 
-	if (!exchangeRes.ok) {
-		const body = await exchangeRes.text().catch(() => "")
-		throw new Error(
-			`OIDC token exchange failed (${exchangeRes.status})${body ? `: ${body}` : ""}`,
-		)
+/**
+ * Detect CI environment and exchange OIDC token for a read-only install token.
+ * Works with both GitHub Actions and GitLab CI.
+ *
+ * @returns {Promise<string>} Short-lived read-only LPM token
+ * @throws {Error} If not in a supported CI environment or exchange fails
+ */
+export async function exchangeOidcInstallToken() {
+	if (isGitHubActionsWithOidc()) {
+		return exchangeOidcToken(null, { scope: "read" })
 	}
-
-	const { token } = await exchangeRes.json()
-	if (!token) {
-		throw new Error("OIDC exchange response did not contain a token")
+	if (isGitLabCiWithOidc()) {
+		return exchangeGitLabOidcToken(null, { scope: "read" })
 	}
-
-	return token
+	throw new Error(
+		"OIDC is not available. This command requires a CI environment with OIDC support " +
+			"(GitHub Actions with `id-token: write` or GitLab CI with `id_tokens` configured).",
+	)
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@lpm-registry/cli",
-	"version": "0.2.4",
+	"version": "0.2.6",
 	"description": "CLI for Licensed Package Manager",
 	"author": "LPM <hello@lpm.dev> (https://lpm.dev)",
 	"repository": {