Registry Stats

日本語 | 中文 | Español | Français | हिन्दी | Italiano | Português (BR)

See download stats for every dependency — right inside VS Code. Supports npm, PyPI, NuGet, VS Code Marketplace, and Docker Hub.

What it does

Registry Stats scans your workspace for package manifests (package.json, pyproject.toml, *.csproj) and pulls live download statistics from five registries. No API keys required for npm, PyPI, NuGet, or VS Code Marketplace.

Three report formats, three audiences:

Getting started

1. Install from the VS Code Marketplace
2. Open a project that has a package.json, pyproject.toml, or *.csproj
3. The status bar shows your primary package's download count automatically
4. Click the Registry Stats icon in the activity bar to open the sidebar

Features

Status bar

Your primary package's weekly downloads appear in the status bar. Hover for a detailed tooltip with daily, weekly, monthly, and all-time counts. Click to open the sidebar.

Hover on dependencies

Hover over any dependency name in package.json, pyproject.toml, or *.csproj to see its download stats in a tooltip table.

Sidebar with audience switcher

The sidebar lets you switch between Executive, LLM, and Dev report views. Hit Refresh to fetch fresh data, Copy to clipboard, or Export to save to file.

• Executive exports as PDF (generated with pdfmake — no browser engine, works everywhere)
• LLM exports as JSONL (one JSON object per line, includes freshness and error metadata)
• Dev exports as Markdown (collapsible raw trace, structured error listing)

Generate Report command

Ctrl+Shift+P → Registry Stats: Generate Report walks you through:

1. Pick an audience (Executive / LLM / Dev)
2. Pick an output (Copy / Save / Preview in editor)

Commands

Supported registries

Manifest detection

The extension auto-detects your workspace's packages:

Settings

Caching

Stats are cached in VS Code's globalState (persists across restarts). Each registry has its own TTL. The extension uses stale-while-revalidate: if cached data exists but is stale, it's returned immediately while a background refresh runs. This keeps the UI fast.

Report formats in detail

Executive (PDF)

A one-page report generated with pdfmake (pure JavaScript, no Chromium required). Contains:

• KPI cards: total packages, registries covered, data freshness, failures
• Top 15 packages ranked by weekly downloads
• Registry breakdown table
• Risks and recommendations

LLM (JSONL)

Schema-versioned JSON Lines output. Each line is a self-contained JSON object:

{"type":"header","schema_version":"1.0","run_id":"...","workspace":{...}}
{"type":"package","registry":"npm","name":"express","downloads":{...},"freshness_hours":0.5}
{"type":"package","registry":"pypi","name":"flask","error":{"code":"FETCH_FAILED","retryable":true}}
{"type":"summary","total":48,"succeeded":45,"failed":3,"duration_ms":2100}
{"type":"trace","level":"info","component":"fetcher","event":"fetch.complete","duration_ms":1800}

Every stat includes freshness_hours and source_registry so LLMs can reason about data quality.

Dev (Markdown)

Structured Markdown with collapsible sections:

• Run Summary — success/fail/stale counts, total duration
• Registry Breakdown — per-registry table
• Manifest Scan — which files contributed which packages
• Per-Package Results — full stats table
• Errors — structured error details with retry hints
• Trace — raw event log in a collapsible <details> block

Threat model

Data touched: Package names and download counts from public registry APIs. Manifest files (package.json, pyproject.toml, *.csproj) are read to detect dependencies — no file writes.

Data NOT touched: Source code contents, credentials, environment variables, git history, terminal output.

Network: Read-only requests to public APIs (npm, PyPI, NuGet, VS Code Marketplace, Docker Hub). No data is sent upstream. The optional Docker Hub token is stored in VS Code settings.

No telemetry. No analytics. No tracking.

Scorecard

Assessed with @mcptoolshop/shipcheck.

Built with

• @mcptoolshop/registry-stats — the core stats engine (zero dependencies)
• pdfmake — PDF generation (pure JS, no native deps)

Built by MCP Tool Shop