smuggle

name	smuggle
description	Use when the user wants to test a local npm package in a consumer project, replace node_modules with a local build, hot-reload local packages, or avoid npm link / symlink issues. Also use when the user mentions "smuggle", "local package testing", or asks how to test a package they're developing locally.
allowed-tools	Bash, Read, Glob, Grep

Smuggle — Local npm Package Testing

Smuggle lets you test local npm packages in real consumer projects by directly overwriting files in node_modules. No symlinks, no lockfile pollution, no .npmrc hacks. Originals are backed up and restored on exit.

Prerequisites

Check if smuggle is installed:

smuggle --help

If not installed, install it with one of:

npm install -g smuggle-cli   # via npm
brew install logaretm/tap/smuggle   # via Homebrew
cargo install smuggle   # via Cargo

Commands

smuggle publish — Register local packages

Run this inside the package you're developing (or a pnpm workspace root). It packs the package the same way npm publish would and stores the tarball in ~/.smuggle/packages/.

# Interactive — select which packages to publish
smuggle publish

# Publish all non-private packages in a workspace
smuggle publish --all