v0.2 — workspaces · audit · monorepos

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

npm 11.6
npm ci
13.0 s
bun 1.2
bun
2.43 s
stil 0.2
0.21 s

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

npm 11.6
npm install
14.5 s
bun 1.2
bun install
6.20 s
stil 0.2
stil install
0.68 s

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

bun 1.2
bun install
2.68 s
stil 0.2
stil install
0.35 s

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:*

stil 0.2
stil install --frozen-lockfile
21 ms

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

Featurenpmpnpmbunstil
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 s2.43 s0.21 s
Fresh Next.js 16 (352 pkg, no lockfile)14.5 s—6.20 s0.68 s