pnport
pnport is a command-line tool for running subprocesses against an installed Yarn 4 Plug'n'Play project. Its virtual node_modules view is intended for programs that read dependencies as ordinary files, without creating a physical project dependency tree. Supported hidden tool caches can coexist with that view.
pnport 0.1.2 is available. Install through npm latest, signed GitHub release archives, the POSIX installer, or Homebrew. Intermittent macOS initialization failures and cancellation returning 125 instead of the signal-derived status remain unresolved. Complete filesystem/process compatibility is unverified. The experimental 0.1.0-next.1 preview remains on npm next and its signed prerelease archives; its bytes are unchanged.
See installation and availability for the registry check, installation commands and known stable and preview limits. Pin the exact version when reporting a failure.
To try the published preview with Turbopack or TypeScript 7, follow preview testing.
Release targets
The 0.1.2 release targets macOS 15+ and Ubuntu 22.04-equivalent glibc Linux, each on x64 and arm64. The published build passed native execution and installation checks on all four targets. Windows 10 22H2+ with MSVC on x64 and arm64 is planned for 0.2.0, with the same complete validation requirements. Linux static child executables were included in those checks. Musl hosts and mixed-architecture execution are outside the target set.
The stable build passed native execution, installation, inline/split TypeScript and numerical benchmark checks on macOS 15 and Ubuntu 22.04 for both architectures, including dynamic and static Linux children. These checks do not establish support for every executable. Full filesystem/process acceptance remains incomplete, and the macOS failures above remain unresolved. The preview retains its separate limitations. Windows execution remains unavailable. See installation and availability for the current status.
What the CLI is designed to do
- Select one installed Yarn 4 PnP project without changing the subprocess's working directory.
- Give supported subprocesses a read-only dependency view, including ZIP-backed packages, while preserving ordinary source and output writes.
- Keep child standard streams and exit status intact, so protocol-based tools can use stdout.
- Report unsupported children explicitly and require a restart when the dependency graph changes, without silently running outside the virtual view.
Start with getting started and the command reference. The filesystem and process guide explains the boundaries.
Guides
- Installation and availability
- Getting started
- Preview testing
- Commands
- Filesystem and processes
- Editors and language servers
- Cache management
- Diagnostics and troubleshooting
- Benchmarks
- Releases and rollback
Report problems through Delino OSS GitHub Issues. There is no support response-time commitment.