Automic VaultAutomic Vault

brew

Install npq with Homebrew

Audit npm packages before you install them. Version 3.20.0 via Homebrew; verified 2026-07-08.

install

Additional install commands

macOS

Homebrewverified ยท 100%
brew install npq

local Homebrew formula metadata

overview

Package summary

Audit npm packages before you install them

Commands and aliases

  • npq
  • npq-hero

history

Project history and usage

npq is a Node.js command-line security wrapper that audits npm package installs before handing off to the real package manager. The npm package was created on 2017-11-28, and the GitHub repository was created on 2017-12-14.

Project history

The project grew out of concern about npm supply-chain risk: newly published packages, low-download typo targets, missing metadata, vulnerable packages, and pre/post-install scripts. Its README says npq performs syntactic heuristics and queries a CVE database, then delegates the actual install to npm by default or another package manager selected through NPQ_PKG_MGR.

The npm registry metadata consulted for this batch reported latest version 3.19.6 published on 2026-06-03 and 176 published versions. The README also documents npq-hero, an alias/wrapper path for embedding npq into day-to-day npm usage.

Adoption history

npq is smaller than npm-check-updates but has durable adoption among JavaScript developers who want an interactive pre-install safety check. Its README lists third-party coverage and mentions in npm security discussions, and the GitHub metadata consulted for this batch reported about 1.8k stars.

npm's public downloads API reported 32,098 downloads for npq from 2026-05-30 through 2026-06-28 and 171,829 downloads from 2025-06-29 through 2026-06-28. Homebrew analytics reported 1,862 formula installs over its 365-day window.

How it is used

Package nerds use npq when installing unfamiliar packages, especially ad hoc CLI tools or direct dependencies discovered during development. Typical usage is npq install express, npx npq install express --dry-run, or aliasing npm to npq-hero so package installs pass through the checks automatically.

npq's checks are intentionally heuristic, not a proof of safety. The useful behavior is friction: warn on risky signals such as very new packages, missing README or license metadata, known vulnerabilities, install scripts, maintainer/publisher concerns, and low popularity before executing the actual package-manager install.

Why package nerds care

npq represents the npm ecosystem's shift from post-install vulnerability scanning toward pre-install package-health review. It is part of the same cultural space as minimum release age, lockfile linting, provenance checks, and package firewalls.

Timeline

  • 2017-11-28: npm registry package npq created.
  • 2017-12-14: GitHub repository lirantal/npq created.
  • 2026-06-03: npm registry metadata reports version 3.19.6 published.

Related projects

  • npm audit
  • Snyk
  • Socket Firewall
  • lockfile-lint
  • npq-hero
  • pnpm
  • bun

security posture

No protected-tool coverage found yet

No matching local secret-handling manifest was found for npq. Nucleus package metadata is still published here so future coverage has a stable package URL.

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 1 platform targets.
  • Installs with 1 runtime dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

CommandKindExposureNote
npqcliglobal executable
npq-herocliglobal executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08
manager version3.20.0
manager updated2026-07-08
local dataok
upstreamnot checked
latest detectednot detected

https://github.com/lirantal/npq

install metadata

Package metadata

Package keybrew:npq
Version3.20.0
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/npq
Homepagehttps://github.com/lirantal/npq
Repositoryhttps://github.com/lirantal/npq
Upstream docshttps://github.com/lirantal/npq#readme
LicenseApache-2.0
Source archivehttps://registry.npmjs.org/npq/-/npq-3.20.0.tgz
Last updated2026-07-08T09:52:12Z
Pulseupdated
Dependenciesnode
Bottleavailable (on all)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Namenpq
Version Scheme0
Revision0
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • stable

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated package history
  • package relationship graph
  • package version freshness
  • package-page enrichment