Skip to content

Usage:

Terminal
$ vlt docs [<spec>] [--target=<query>]

Open documentation for a package in a web browser.

How It Works

The vlt docs command locates and opens the documentation for any package in your dependency graph. It follows the following resolution strategy to find the best documentation URL:

  1. Homepage field – Checks the package’s home property in its package.json
  2. Repository Resolution – Checks the package’s repository field in its package.json. For known git hosts (GitHub, GitLab, Bitbucket, etc.), generates the canonical documentation URL
  3. Fallback – If no repository is found or the git host is unknown, falls back to the npm package page

This means you always get taken to the most relevant documentation.

Basic Usage

Open docs for current project

When run without arguments, vlt docs reads your local package.json and opens the documentation for your current project:

Terminal
$ vlt docs

This is particularly useful when working on a project and you want to quickly view your own documentation or verify your repository URL is correctly configured.

Open docs for any package

Provide a package spec to open documentation for any package, whether it’s installed in your project or not:

Terminal
# Open docs for a specific package
$ vlt docs express
# Open docs for a specific version
# Open docs for a scoped package
$ vlt docs @vltpkg/graph

The command fetches the package manifest from the registry and determines the best documentation URL to open.

Query packages using —target

Use the --target option with DSS query syntax to find documentation for packages in your dependency graph:

Terminal
# Open docs for a specific package in your graph
$ vlt docs --target="#lodash"
# List documentation URLs for all direct dependencies
$ vlt docs --target=":root > *"
# Find docs for all packages from a specific scope
$ vlt docs --target="[name^=@types]"

Note: When the query matches multiple packages, documentation URLs are listed instead of being opened automatically.

Use Cases

Package Discovery

Quickly research packages:

Terminal
# Compare test frameworks
$ vlt docs tap
$ vlt docs jest
$ vlt docs vitest

Debugging and Support

Access documentation when troubleshooting issues:

Terminal
# Error with a package? Read the docs
$ vlt docs --target="#problematic-package"
# Need API reference?
$ vlt docs @vltpkg/spec

Learning and Exploration

Explore the ecosystem and learn about packages:

Terminal
# Learn about vlt packages
$ vlt docs @vltpkg/graph
$ vlt docs @vltpkg/query
# Explore popular packages
$ vlt docs express $ vlt docs react

Options

--target=<query>

Filter packages using DSS query syntax. When a single package matches, its documentation opens in your browser. When multiple packages match, their documentation URLs are listed.

Terminal
# Open docs for a single package
$ vlt docs --target="#express"
# List docs for all direct dependencies
$ vlt docs --target=":root > *"
# List docs for packages with build scripts
$ vlt docs --target=":scripts"

Notes

  • The command automatically opens your default web browser for single results
  • Works with any valid package specifier (names, versions, tags, etc.)
  • Does not require the package to be installed when using package specifiers
  • With --target, it defaults to only searches packages in your current dependency graph
  • Falls back gracefully to npm package pages when repository info is unavailable
  • Multiple results are displayed as a formatted list instead of opening URLs