api-docs-tooling is a tool to generate API documentation of Node.js. See this issue for more information.

Usage

Local invocation:

$ npx api-docs-tooling --help

Usage: api-docs-tooling [options] [command]

CLI tool to generate and lint Node.js API documentation

Options:
  -h, --help          display help for command

Commands:
  generate [options]  Generate API docs
  lint [options]      Run linter independently
  interactive         Launch guided CLI wizard
  list <types>        List the given type
  help [command]      display help for command

generate

Usage: api-docs-tooling generate [options]

Generate API docs

Options:
  -i, --input <patterns...>  Input file patterns (glob)
  --ignore [patterns...]     Ignore patterns (comma-separated)
  -o, --output <dir>         Output directory
  -p, --threads <number>      (default: "12")
  -v, --version <semver>     Target Node.js version (default: "v22.14.0")
  -c, --changelog <url>      Changelog URL or path (default: "https://raw.githubusercontent.com/nodejs/node/HEAD/CHANGELOG.md")
  --git-ref <url>            Git ref/commit URL (default: "https://github.com/nodejs/node/tree/HEAD")
  -t, --target [modes...]    Target generator modes (choices: "json-simple", "legacy-html", "legacy-html-all", "man-page", "legacy-json", "legacy-json-all", "addon-verify", "api-links", "orama-db")
  --no-lint                  Skip lint before generate
  -h, --help                 display help for command

lint

Usage: api-docs-tooling lint [options]

Run linter independently

Options:
  -i, --input <patterns...>  Input file patterns (glob)
  --ignore [patterns...]     Ignore patterns (comma-separated)
  --disable-rule [rules...]  Disable linter rules (choices: "duplicate-stability-nodes", "invalid-change-version", "missing-introduced-in")
  --dry-run                  Dry run mode (default: false)
  -r, --reporter <reporter>  Linter reporter to use
  -h, --help                 display help for command

interactive

Usage: api-docs-tooling interactive [options]

Launch guided CLI wizard

Options:
  -h, --help  display help for command

list

Usage: api-docs-tooling list [options] <types>

List the given type

Arguments:
  types       The type to list (choices: "generators", "rules", "reporters")

Options:
  -h, --help  display help for command