pkgmap

One command to see everything installed on your machine, across all your package managers.

  ╔═══════════════════════════════════╗
  ║  📦 pkgmap                        ║
  ╚═══════════════════════════════════╝

---

What is pkgmap?

pkgmap scans package managers installed on your machine and displays everything in one clean terminal table, including manager, version, and package type.

No more jumping between npm list -g, brew list, pip list, flatpak list, or distro-specific package commands. One command, one inventory view.

Need a quick port check too? pkgmap ports extends the same CLI to show active listening ports without leaving the pkgmap flow.

---

Supported Package Managers

Icon	Manager	Command Used	macOS	Linux	Windows
📦	npm	npm list -g --depth=0 --json	✅	✅	✅
📦	pnpm	pnpm list -g --depth=0 --json	✅	✅	✅
🧶	yarn	yarn global list --depth=0	✅	✅	✅
🍺	brew	brew info --json=v2 --installed	✅	✅	❌
⚡	volta	volta list --format=plain	✅	✅	✅
🐍	pip	pip3 list --format=json	✅	✅	✅
🦀	cargo	cargo install --list	✅	✅	✅
💎	gem	gem list	✅	✅	❌
🎼	composer	composer global show --format=json	✅	✅	✅
🐘	gradle	scan ~/.gradle/caches/modules-2/files-2.1	✅	✅	✅
☕	maven	scan ~/.m2/repository	✅	✅	✅
🔷	nuget	scan global packages via dotnet nuget locals global-packages --list	✅	✅	✅
🐧	apt	dpkg-query -W -f="${Package}\t${Version}\n"	❌	✅	❌
🏹	pacman	pacman -Q	❌	✅	❌
🎩	dnf	dnf repoquery --installed --qf "%{name}\t%{version}-%{release}"	❌	✅	❌
🧊	flatpak	flatpak list --app --columns=application,version	✅	✅	❌
📦	snap	snap list	❌	✅	❌
🛠	yum	yum list installed -q	❌	✅	❌
🪽	winget	winget list --accept-source-agreements	❌	❌	✅
🍫	choco	choco list --local-only --limit-output	❌	❌	✅
🥤	scoop	scoop export	❌	❌	✅
❄️	nix	nix-env -q --installed --json	✅	✅	✅
🧪	uv	uv tool list	✅	✅	✅
🥟	bun	bun pm ls --global --json	✅	✅	✅
📦	pipx	pipx list --json	✅	✅	✅
🪶	poetry	poetry self show plugins --no-ansi	✅	✅	✅
⎈	helm	helm plugin list	✅	✅	✅
🔌	krew	kubectl krew list	✅	✅	✅
🏔	apk	apk info -v	❌	✅	❌
🦎	zypper	zypper search --installed-only --details --type package	❌	✅	❌
🐡	pkg	pkg info	❌	❌	✅
🐹	go	go env GOPATH + scan $GOPATH/bin	✅	✅	✅
🐍	conda / mamba	conda list --json / mamba list --json	✅	✅	✅
🛠	mise	mise ls --json	✅	✅	❌
🔧	asdf	asdf list	✅	✅	❌
🚢	macports	port installed	✅	❌	❌
🐫	opam	opam list --installed --columns=name,version --color=never	✅	✅	✅
🧱	vcpkg	vcpkg list	✅	✅	✅

Only managers that are installed and return packages will appear in the output.

---

Output

  ╔═══════════════════════════════════╗
  ║  📦 pkgmap                        ║
  ╚═══════════════════════════════════╝

  📦 npm: 4  ·  🍺 brew: 64  ·  🐍 pip: 3  ·  🐧 apt: 1812  ·  🏹 pacman: 512
  Total: 2395 packages across 5 manager(s)

┌──────────┬────────────────────────────┬──────────────┬──────────┐
│ Manager  │ Package                    │ Version      │ Type     │
├──────────┼────────────────────────────┼──────────────┼──────────┤
│ 📦 npm   │ typescript                 │ 5.4.2        │ cli      │
├──────────┼────────────────────────────┼──────────────┼──────────┤
│ 🍺 brew  │ git                        │ 2.44.0       │ formula  │
├──────────┼────────────────────────────┼──────────────┼──────────┤
│ 🐧 apt   │ curl                       │ 8.5.0        │ system   │
└──────────┴────────────────────────────┴──────────────┴──────────┘

---

Prerequisites

• Node.js >= 20 for the supported runtime baseline
• npm bundled with Node.js

If Node.js is not installed yet, get it from nodejs.org or use a version manager like nvm.

---

Install

One-liner

curl -fsSL https://raw.githubusercontent.com/mulhamna/pkgmap/main/install.sh | sh

Auto-detects your OS and picks the best installer.

Via Homebrew (macOS / Linux)

brew tap mulhamna/tap
brew install pkgmap

Via npm / pnpm / yarn / volta / bun

npm install -g @mulham28/pkgmap
pnpm add -g @mulham28/pkgmap
yarn global add @mulham28/pkgmap
volta install @mulham28/pkgmap
bun add -g @mulham28/pkgmap

Manual install

git clone https://github.com/mulhamna/pkgmap.git
cd pkgmap
npm install
npm link

pkgmap

Tip for macOS/Linux: if npm link fails with a permission error, use nvm or fix your npm global prefix instead of relying on sudo.

Tip for Windows: run PowerShell or CMD as Administrator before npm link.

---

Usage

# Scan all package managers
pkgmap

# Scan only one manager
pkgmap --manager brew
pkgmap --manager apt

# Search for a specific package across all managers
pkgmap --search node
pkgmap --search git

# Show only duplicate packages installed via multiple managers
pkgmap --duplicates

# Export results to JSON file
pkgmap --export
# creates pkgmap-export.json

# Print JSON directly to terminal
pkgmap --json

# Show active listening ports
pkgmap ports

# Show only suspicious listeners (orphan / zombie)
pkgmap ports --check

# Gracefully stop whatever owns a port
pkgmap ports --kill 3000

# Force-kill a stuck listener
pkgmap ports --kill 3000 --force

# Show active listening ports as JSON
pkgmap ports --json

---

Flags

Flag	Shorthand	Description
--manager <name>	-m	Scan only a specific package manager
--search <package>	-s	Search for a package by name
--duplicates	-d	Show only packages installed via multiple managers
--export	-e	Export results to pkgmap-export.json
--json	-j	Print results as JSON to stdout
--version	-V	Show version
--help	-h	Show help

Ports subcommand

Command	Description
pkgmap ports	Show active listening TCP ports
pkgmap ports --check	Show only orphan or zombie listening TCP ports
pkgmap ports --kill <port-or-pid>	Send SIGTERM to the process behind a listening port or PID
pkgmap ports --kill <port-or-pid> --force	Send SIGKILL instead of SIGTERM
pkgmap ports --json	Print active listening TCP ports as JSON

---

Edge Cases Handled

• Manager not installed, silently skipped
• Manager installed but no packages, also skipped
• Permission issues, warning shown and scan continues
• Slow scanners, timeout and skip with a warning
• Duplicate packages across managers, highlighted with cross-manager hints
• Active listening TCP ports via pkgmap ports
• Orphan / zombie listener checks via pkgmap ports --check
• Graceful or forced listener termination via pkgmap ports --kill <port-or-pid>
• Windows compatibility, unsupported managers auto-skipped and longer npm timeout applied
• Arch Linux, Fedora/RHEL, Alpine, openSUSE, FreeBSD, Windows, Nix, Python tooling, Bun, OCaml, MacPorts, vcpkg, and Kubernetes plugin ecosystems are now covered

---

Adding a New Scanner

1. Create src/scanners/<name>.js
2. Return this shape:

export default async function scan() {
  return {
    manager: 'mymanager',
    packages: [
      { name: 'some-package', version: '1.1.1', type: 'library' }
    ]
  }
}

3. Register it in src/index.js
4. Add an icon in src/display/table.js

---

Tech Stack

• Runtime: Node.js (ESM)
• commander for CLI flags
• chalk for terminal colors
• cli-table3 for table rendering
• ora for the scanning spinner

---

License

MIT, see LICENSE.