Skip to content

v0.0.1

Choose a tag to compare

View all tags
@zamdevio zamdevio released this 25 Jun 09:59
· 8 commits to main since this release
v0.0.1
53f83b3

nodehunter 0.0.1 — initial public release

First public release of nodehunter — a safety-first CLI and SDK for finding, measuring, and cleaning node_modules directories across workspaces.

Docs: https://nodehunter.pages.dev

Install

# CLI
npm install -g nodehunter

# SDK (recommended for apps, CI, and libraries)
npm install @nodehunter/core

On-demand:

npx nodehunter scan ~/Projects
pnpm dlx nodehunter --help

Highlights

  • Safety by default — bare nodehunter prints help; scan is read-only; delete shows a sized preview and asks for confirmation (default no; use --yes only when you mean it).
  • Workspace intelligence — list, find, why, and inspect (duplicates, drift, risks, largest, …) across many projects in one scan.
  • Physical disk sizing — size prefers native du on Linux/macOS; portable Node walk on Windows or with --no-du.
  • Machine output — global --json with stable envelopes for scripts and CI.
  • Enrichment cache — per-project cache under ~/.cache/nodehunter (--no-cache, --force).
  • Cross-platform — Linux, macOS, Windows (including WSL); CI matrix on all three.

CLI commands

Command Purpose
scan Find node_modules paths (read-only)
size Measure disk usage
list List projects or filter installs
find Locate a package across the workspace
why Explain package footprint
inspect Analytics lenses (duplicates, drift, risks, …)
delete Remove after preview + confirmation
version Semver; --check (npm latest); --reset (update cache)
help Command reference

Packages

npm package What you get
nodehunter Self-contained CLI (dist/cli.js — core compiled in at build time). Optional import from 'nodehunter/core' from the same tarball.
@nodehunter/core Standalone SDK — recommended for programmatic use in apps, services, and CI.

SDK

  • Host-neutral runScan, runSize, runList, runFind, runWhy, runInspect, runDelete*
  • Export tiers: stable / advanced / internal (pnpm exports:validate)
  • Runnable examples under examples/sdk/

Also in this release

  • VitePress docs site (apps/docs) with deploy to Cloudflare Pages
  • nodehunter version with npm update checks and banner reminders
  • SDK_VERSION / SDK_PACKAGE_NAME exports from @nodehunter/core
  • Windows CI fixes for cache debug paths and delete failure handling

Requirements

  • Node.js >= 18

Links

Full changelog: v0.0.1...v0.0.1
(First tag — see commit history on main for prior development.)

Assets 2
Loading