npm install
a Node.js package manager
that won't ship you a RAT.
npm, pnpm, and bun all run lifecycle scripts with full host access. One
bad postinstall and your ~/.ssh is gone.
stil sandboxes every script inside a Hull microVM, blocks day-zero
versions, queries the npm advisory bulk in parallel
to the install, and still runs ~9× faster than bun
on a fresh Next.js.
// stil in 30 seconds
30 s · Spanish audio — why stil exists, how it sandboxes
postinstall, and what a monorepo gains moving from
npm to stil.
// Benchmarks
Warm install — frozen lockfile, content cache hot
197 packages · React 18 + Vite 6 + framer-motion + jspdf · Apple Silicon
stil is ~12× faster than bun and ~62× faster than npm.
Hot install — fresh Next.js 16, no lockfile
352 packages · Next 16.2 + React 19 + Tailwind 4 + TypeScript · BFS resolution + advisory DB · Apple Silicon
stil is ~9× faster than bun and ~21× faster than npm — and surfaces GHSA-qx2v-qp2m-jg93 in one of the transitive deps along the way.
TanStack Router fresh — 222 packages, no lockfile
React 19 + Vite 8 + TanStack Router · parallel advisory DB active
stil ~8× faster than bun — audit overhead is ~12 ms thanks to overlapping the POST with the link phase.
Monorepo — 3 workspaces, frozen v2 lockfile
apps/web depends on packages/ui and packages/utils via workspace:*
workspaces resolve to symlinks without touching the registry; the rest comes out of the store via clonefile(2).
// This page runs on stil
The landing you're reading lives in a folder called landing/,
built with Vite + TypeScript. To dev it and ship it we use
stil itself — it's our own best test bed.
$ cd landing/ $ stil install # resolves vite + transitives + rollup native binaries 186 packages planned $ stil run dev # vite boots in milliseconds > dev > vite VITE v6.4.2 ready in 117 ms $ stil run build # tsc + vite build, dist/ ready to deploy ✓ built in 1.6s
// Case study — npm → stil migration
A production Next.js 15 app (seating reservations, ~515 packages). A
single stil install migrates the project and fires the
built-in advisory DB, surfacing 44 advisories the team didn't know
about — including an RCE critical in next before the next
deploy.
$ rm -rf node_modules $ stil install # reads package.json, ignores package-lock.json 515 packages installed in 1.30s # warm, audit overlaps the link phase --- security advisories (44) --- [critical] next@15.3.2: RCE in React flight protocol [high] axios@1.11.0: prototype pollution + header injection + DoS (×6) [high] xlsx@0.18.5: prototype pollution + ReDoS (×2) [high] next@15.3.2: DoS + middleware bypass + SSRF (×8) summary: 1 critical, 17 high, 22 moderate, 4 low
Three audit-guided bumps and the criticals are gone:
$ stil add 'next@^15' # 15.3.2 → 15.5.18, patches the RCE $ stil add 'axios@^1.12' # 1.11.0 → 1.16.0, patches 6 high $ stil add 'seatsio@^87' # 85 → 87, bumps nested axios to 1.15 $ stil install summary: 0 critical, 6 high, 9 moderate, 1 low # −64% advisories $ stil run build ▲ Next.js 15.5.18 ✓ Compiled successfully in 4.7s # 43 pages, no breaking changes
From 44 advisories down to 16 in one
session — −64%, including the critical RCE, without
touching the app code. The 6 remaining highs need upstream action
(xlsx has no patched version in npm; axios is
nested via seatsio).
// Why stil exists
Sandboxed lifecycle scripts
Scripts run inside a Hull microVM with seccomp KILL_PROCESS on the node profile (32 syscalls). No network, no ~/.ssh, no ~/.aws. Escape attempts kill the process. Skipped entirely by default.
7-day age policy
Brand-new versions are blocked by default — maintainers and advisories need time to notice a compromise. The resolver auto-falls-back to the latest version that satisfies the constraint and the age policy. Even when your package.json pins "latest", stil rolls back to the latest stable that passes.
Advisory bulk on every install
Once the install plan is built, stil POSTs the (name, version) list to npm's bulk advisory endpoint and reports any finding with severity + URL. --audit-level=high aborts the install with exit 1 on a critical CVE. The POST runs in parallel with the link phase, so the net overhead is ~12 ms.
Verified content store
sha512 / sha256 / sha1 verified before the tarball touches disk. Stored once, hardlinked into every project — clonefile(2) on macOS, ~200 syscalls instead of ~10k for a typical install.
HTTP/2 multiplexed fetch + ETag cache
libcurl Multi handle, 8 parallel connections to npmjs, dozens of streams per connection. Persistent packument cache at ~/.stil-cache/ with a 24h TTL and If-None-Match revalidation — stale entries get a near-empty 304 instead of a full re-download.
Drop-in for Vite / Next / Astro
Resolves optionalDependencies with os / cpu filters, so platform native binaries (@rollup/rollup-darwin-arm64, esbuild, &c.) land on disk and vite build just works.
Zig, not JavaScript
Single ~1 MB static binary (~10 MB on Linux). No Node.js runtime, no npm bootstrap, no startup tax. Boots in milliseconds, not the half-second npm takes to load itself.
One-command deploy
stil mentat init autodetects the stack (Next.js, Vite, Java, Node) and writes a Mentat up.yaml ready for mt up. It reads your env var names from .env and leaves them as <SET_ME> — never copies secrets into the manifest.
// Monorepos & workspaces
Native npm/yarn-style workspaces. Each package consumes the others via
workspace:* and stil resolves the dep to a local symlink —
no registry round-trip, no duplicate entry in the store.
# monorepo root package.json { "name": "myrepo", "private": true, "workspaces": ["packages/*", "apps/*"] } # packages/ui/package.json { "name": "@myrepo/ui", "dependencies": { "@myrepo/utils": "workspace:*", "react": "^18" } } $ stil install # creates symlinks + hardlinks monorepo: 3 workspaces discovered 4 packages planned $ cd packages/utils && stil install # from a sub-workspace, finds the root by itself stil: in workspace 'utils', running install from monorepo root '/path/to/myrepo' $ stil run dev --filter '@myrepo/*' # runs dev in every matching workspace [apps/web] > dev > vite
// Install
One line — macOS & Linux
$ curl -fsSL https://stil.gitweave.run/install.sh | bash
Detects OS + arch, downloads the static binary
(macOS arm64 — Intel via Rosetta; Linux x86_64-musl and aarch64-musl)
into ~/.local/bin and creates the stilr symlink
(≡ stil run). The download is SHA256-verified against the
published checksums before install. In Dockerfiles and CI, pin with
STIL_VERSION=0.2.12 — the unpinned URL is a rolling
"latest" that moves on every release.
Installer overrides
# where the binary lands (default: ~/.local/bin) $ STIL_INSTALL_DIR=/usr/local/bin curl -fsSL https://stil.gitweave.run/install.sh | bash # alternate download base (your own mirror) $ STIL_RELEASE_BASE_URL=https://my-host/bin curl -fsSL …/install.sh | bash
Daily use
$ stil install # 7-day age policy on by default $ stil install --frozen-lockfile # CI: skip BFS, install exact lockfile $ stil add react@^18 -D # devDependency $ stil add chalk -w '@my/utils' # into a specific workspace $ stil update # bump everything to latest valid $ stil run dev # scripts.dev from package.json $ stil run dev --filter '@my/*' # in every matching workspace $ stil mentat init # generate a deploy up.yaml from the stack
Cross-volume tip (macOS)
# macOS clonefile(2) and hardlinks don't cross APFS volumes. # If your projects live on /Volumes/Foo, point the store there too: $ export STIL_STORE=/Volumes/Foo/.stil-store
// vs other package managers
| Feature | npm | pnpm | bun | stil |
|---|---|---|---|---|
| Sandboxed lifecycle scripts | ✗ | ✗ | ✗ | ✓ Hull microVM |
| Release-age policy by default | ✗ | ✗ | ✗ | ✓ 7-day |
| Advisory DB on every install | ~ npm audit (separate) | ✗ | ✗ | ✓ parallel |
| Content-addressed store | ✗ | ✓ | ✓ | ✓ |
| HTTP/2 multiplexed fetch | ✗ | ~ | ✓ | ✓ |
| Workspaces / monorepos | ✓ | ✓ | ✓ | ✓ |
| Private registries / auth | ✓ | ✓ | ✓ | v0.3 |
| Warm install (197 pkg, frozen) | 13.0 s | ~3 s | 2.43 s | 0.21 s |
| Fresh Next.js 16 (352 pkg, no lockfile) | 14.5 s | — | 6.20 s | 0.68 s |