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.

---

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	✅	✅	❌

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

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

---

Flags

Flag	Shorthand	Description
--manager <name>	-m	Scan only a specific package manager
--search <package>	-s	Search for a package by name
--export	-e	Export results to pkgmap-export.json
--version	-V	Show version
--help	-h	Show help

---

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
• Windows compatibility, unsupported managers auto-skipped and longer npm timeout applied
• Arch Linux, Fedora/RHEL, Alpine, openSUSE, FreeBSD, Windows, Nix, Python tooling, Bun, 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.