npm-info

name	npm-info
description	Get detailed metadata for an npm package including versions, dependencies, maintainers, and repository information. Use when the user asks for package details, version history, or package metadata.

Get npm Package Information

Retrieve detailed metadata for a specific npm package.

Usage

npx tsx scripts/info.ts <package-name> [options]

Arguments

Argument	Required	Description
package-name	Yes	The exact package name (case-sensitive)

Options

Option	Description
--no-cache	Bypass cache and fetch fresh data from API

Output

react
------
Description: React is a JavaScript library for building user interfaces.
Latest: 18.2.0
License: MIT
Homepage: https://react.dev
Repository: https://github.com/facebook/react

Versions (last 5):
  18.2.0 - Published 2022-06-14
  18.1.0 - Published 2022-04-26
  18.0.0 - Published 2022-03-29
  17.0.2 - Published 2021-03-10
  17.0.1 - Published 2020-12-20

Maintainers:
  - @hzoo
  - @acdlite

Script Execution (Preferred)

npx tsx scripts/info.ts <package-name> [options]

Options:

• --no-cache - Bypass cache and fetch fresh data from API

Run from the npm-registry plugin directory: ~/.claude/plugins/cache/npm-registry/

Package Metadata API

GET https://registry.npmjs.org/{package}

Parameters

Parameter	Required	Description
package	Yes	The exact package name (case-sensitive)

Examples

Get package metadata:

https://registry.npmjs.org/react

Response Format

The response contains comprehensive package metadata:

• name - Package name
• versions - Object mapping version numbers to full version metadata
• dist-tags - Tags like latest, next, canary
• time - Timestamps for each version publish
• maintainers - Array of package maintainers
• description - Package description
• homepage - Project homepage URL
• repository - Repository information (type, URL)
• bugs - Bug tracker URL or email
• license - License identifier
• author - Author information
• keywords - Array of keywords
• dependencies - Production dependencies (per version)
• devDependencies - Development dependencies (per version)
• peerDependencies - Peer dependencies (per version)

Repository URL Formats

The registry accepts various repository URL formats:

• https://github.com/owner/repo
• git+https://github.com/owner/repo
• [e-mail]:owner/repo
• ssh://[e-mail]/owner/repo

These are automatically parsed and normalized.

Caching

Package metadata is cached for 6 hours. Versions change infrequently, and most metadata remains stable between releases.

Use the --no-cache flag to bypass the cache.

Related

• Use npm-search to find packages before getting details
• Use npm-exists for a quick availability check
• Use npm-downloads to see usage statistics

Error Handling

Package not found: If the package doesn't exist, you'll receive a 404 response. Use npm-exists to check availability first.

Invalid package name: Package names must be valid npm package names (lowercase, can contain hyphens, underscores, periods).

Scope issues: For scoped packages like @babel/core, include the scope in the name.