npm-peek 🔍

A CLI tool that lets you visually compare your installed npm package versions with any available release. Autocomplete helps you select a package, then pick a version to visually diff against your current one.

🚀 Quick Start

Use npm-peek instantly with npx:

# Interactive mode with autocompletion using your package.json
npx npm-peek

# Direct comparison mode with specific package & version
npx npm-peek react --target 19.1.0

🎥 Showcase

✨ Key Features

• Smart Dependency Detection: Automatically finds and lists all packages from your package.json
• Fuzzy Search: Quickly locate packages with partial name matching
• Version Autocomplete: Easily select from all available versions of a package
• Visual Diff Viewer: See all changes in a clean, browser-based HTML interface
• One-Command Operation: Compare versions with minimal typing
• Zero Configuration: Works out-of-the-box with any npm project

🔧 How It Works

1. Reads package.json to identify dependencies and used version
2. Prompts you to select a package and target version (with autocomplete)
3. Generates a visual diff
4. Opens the diff in your default browser

📦 Releases

This repo uses Changesets.

1. For any user-facing package change, run bun run changeset and commit the generated file in .changeset/.
2. When changesets reach main, GitHub Actions opens or updates a release PR with the version bump and generated CHANGELOG.md.
3. Edit that PR's changelog however you want.
4. Merge the release PR.
5. The release workflow publishes to npm with Trusted Publisher.

That keeps changelog generation automatic, but still makes the final changelog a normal reviewed git diff before publish.