PNPM Catalog Manager

A Visual Studio Code extension for managing dependencies in pnpm workspace catalogs. It provides inline version information, update notifications, and quick actions for packages defined in your pnpm-workspace.yaml file.

Features

• LENS:
  • workspace.yaml - shows catalog version
  • package.json - shows installed version
• CMD + Click "workspace:" to open workspace package
• CMD + Click "catalog:" to open pnpm catalog
• COMMANDS:
  • Update to Latest (hover action)
  • PNPM Catalog: Install or Update Dependency
    • Search npm or local workspace packages
    • Add new packages to catalog or manage existing ones
    • Select version from npm or type a custom version
    • Add/remove from multiple workspace packages at once
  • PNPM Catalog: Add Workspace Dependency
    • Add a workspace package as a dependency to multiple target packages
  • PNPM Catalog: Uninstall Dependency
    • Remove a dependency from the catalog(s) and all workspace packages in one step

Previews

Command Click

Update to latest command

Install Dependency Command

Webview UI

Requirements

• pnpm must be installed and available in your PATH
• A valid pnpm-workspace.yaml file in your workspace

How It Works

1. When you open a pnpm-workspace.yaml file, the extension runs pnpm outdated -r --json to fetch outdated package information
2. Results are cached per workspace for 5 minutes to avoid repeated calls
3. Hover information is fetched on-demand from the npm registry and cached for 5 minutes
4. The cache is automatically refreshed when you switch workspaces or when pnpm-lock.yaml changes (e.g. after pnpm install)
5. While the first check runs, catalog lines show checking…; if the check fails, they show unknown with a notification offering a retry
6. Use the PNPM Catalog: Refresh Outdated Packages command to force a fresh check at any time

Known Issues

• The extension relies on pnpm outdated which requires packages to be installed. If you have a fresh workspace without node_modules, run pnpm install first.
• Version decorations may take a moment to appear on first load while the outdated check runs.