Skip to main content

devmap

A source-of-truth scanner and governance layer for your machine's development environment. One command maps the whole dev setup, draws the PATH-conflict graph, and surfaces ghost binaries and multi-version collisions.

devmap is the developer-focused spiritual successor to fastfetch: instead of only printing system specs, it scans the development surface of your machine — runtimes, package managers, IDEs, per-interpreter pip packages, conda/WSL/Docker environments, Visual Studio dev shells, and project-local virtual environments — and produces a single machine-readable manifest plus an actionable issue list.

Install

This PyPI package ships the real devmap CLI. It bundles the compiled devmap app and launches it via Node.js (or Bun, if present), so it works standalone — no need to install from npm or build from source:

pip install devmap
devmap scan

Requirements at runtime: a Node.js (or Bun) runtime available on PATH. Python itself is only used as the installer/launcher wrapper.

Features

  • One-command full scan of the dev environment (runtimes, package managers, IDEs, and the environment layers below).
  • PATH conflict graph: detects multi-version tools, shadowed binaries, and ghost/broken symlinks (e.g. Windows App Execution Aliases that look broken but aren't).
  • Off-PATH awareness: reports installed-but-not-on-PATH tools, while correctly treating version-manager environments (conda envs, nvm versions) as by-design off-PATH.
  • Environment layers: vcpkg packages, per-python pip packages (incl. upgradable), apt packages (Linux), conda environments, Docker (binary + daemon + images/containers), WSL distros, Visual Studio dev shells, and project-local environments (.venv, node_modules).
  • Dependency auditing (optional): with --audit-deps, devmap detects and invokes installed SCA tools (osv-scanner, govulncheck, pip-audit, Trivy), parses their JSON, and merges results into a unified view. devmap is a scanner/orchestrator, not a CVE database — for authoritative vulnerability data, use those tools directly.
  • Health layer: converges official self-checks into one view, per environment. Offline by default: pip check runs for every Python interpreter, and conda doctor runs for every conda env. With --health-network, npm doctor / rustup check are added. Missing/offline probes degrade gracefully to info (skipped). Only warn/error surface under issues (N); passing checks are summarized as ✓ N checks passed.
  • Three sub-commands: scan (the fact source), query (ask the manifest), devdiff (compare two manifests — environment drift / cross-machine consistency).
  • Zero Python dependencies. The bundled app is pure TypeScript compiled to JavaScript.

Usage

devmap scan                        # pretty-print to terminal, write ~/.devmap/devmap.json
devmap scan --json                # machine-readable JSON (devmap.json schema) to stdout
devmap scan --report              # full markdown report
devmap scan --scan-root C:\src     # also scan project-local envs under a root (comma-separated for many)
devmap scan --wsl-deep            # also wake stopped WSL distros and probe their tools (slower)
devmap scan --outdated            # hit PyPI to list upgradable pip/conda packages (slower, needs network)
devmap scan --ci                  # exit code 1 if any error-severity issue is found
devmap scan --audit-deps          # invoke installed SCA tools and merge CVE findings

Key scan flags:

Flag Description
--json Emit machine-readable JSON (the devmap.json schema) to stdout.
--report Emit a full markdown report.
--no-manifest Do not persist the manifest to disk.
--manifest <path> Read/write the manifest at a custom path (default ~/.devmap/devmap.json).
--disable <r1,r2> Disable check rules by ID prefix (e.g. path.duplicate, pip.outdated).
--scan-root <dir> Root(s) to scan for project-local environments (comma-separated). Default: cwd.
--outdated Network check for upgradable pip/conda packages (off by default).
--wsl-deep Probe inside stopped WSL distros (off by default to avoid waking them).
--audit-deps Invoke installed SCA tools and merge CVE findings into the report.
--ci Exit non-zero on any error-severity issue.
--quiet Suppress the live scan progress feedback (for scripts/CI).
--bom Prefix output with a UTF-8 BOM so Notepad-like viewers render it correctly (stdout redirect/pipe only).

query — ask the manifest

devmap query                       # everything
devmap query node                 # tools whose id contains "node"
devmap query runtime.node         # dot-form category.tool selector (runtime / pkg / ide)
devmap query --issues             # only issues
devmap query --conflicts          # only conflicts (multiVersion / path / ghost)
devmap query --off-path           # only off-PATH installs
devmap query --kind runtime       # filter by category
devmap query --where conda        # filter by install path substring

devdiff — compare two manifests

devmap devdiff                    # stored manifest  vs  current live scan
devmap devdiff <file>             # stored/before    vs  <file>
devmap devdiff <a> <b>            # compare two manifest files

Reports added/removed installs, version changes, and issues added/resolved.

Output

  • The default scan writes the manifest to ~/.devmap/devmap.json (pure UTF-8, no BOM — directly parseable by Bun/Node/Python/jq).
  • Use query / devdiff against a stored manifest without re-scanning.

Repository

https://github.com/StevenLOL/devmap

License

MIT

Metadata

Release files for devmap 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for devmap 0.4.1
File Size Uploaded Provenance Actions
devmap-0.4.1.tar.gz 42.4 kB Without provenance Details for devmap-0.4.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for devmap 0.4.1
File Interpreter ABI Platform Actions
devmap-0.4.1-py3-none-any.whl Python 3 none any Details for devmap-0.4.1-py3-none-any.whl

Total release size: 82.6 kB

Release files / devmap-0.4.1.tar.gz

Download URL devmap-0.4.1.tar.gz
Size 42.4 kB
Tags Source
SHA-256 checksum
How to use checksums
641a19d1df89790c40f2a6639c113dde6955c1f4bd3f09bf3483915238ff85fb
BLAKE2b-256 checksum
How to use checksums
afe77e0127e369c37226c0270e69e2ddb2ac883a4fd4be1ceffea75c3a91c2ce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.9

Release files / devmap-0.4.1-py3-none-any.whl

Download URL devmap-0.4.1-py3-none-any.whl
Size 40.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
65b469d9316e8e45fbd56e2b8ea698d522b2e9d03a21e433b60e45145a0f2306
BLAKE2b-256 checksum
How to use checksums
27f9f9f4eb0d482603263ac93bfafa2301f6b528ecd03b690c4ada99a54d82e0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.9

Security for devmap 0.4.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page