Find where JavaScript and TypeScript declarations are used. The CLI and library resolve references through imports and aliases, distinguish direct calls from other reads, and trace paths from source entry points. Scanning reads the project without running its code.
In a JavaScript or TypeScript project with Node.js 26 or newer:
npm install --save-dev code-inventory
npx code-inventory .For a checkout of this repository, use the fixture to check how calls are counted. CI uses the version in .node-version.
npm ci --ignore-scripts --no-audit
npm run build
node dist/cli.js test/fixtures/basic --symbol normalizeThe fixture calls normalize through the imported name clean, assigns it to another variable, and passes it to an array callback. The first two lines of the result are:
normalize (definitions.ts:0:function)
9 references; 4 direct call sites; 3 distinct callers
The lines that follow identify each reference by file, line, column, kind, and scope. The callback argument on line 9 appears as a read. For a name shared by multiple declarations, query one of the IDs in the ambiguity message.
| Question | Command from the repository root |
|---|---|
| What declarations are in the fixture? | node dist/cli.js test/fixtures/basic |
| What can the application entry reach? | node dist/cli.js test/fixtures/basic --entry app.ts --format markdown |
| How do I save the full snapshot? | node dist/cli.js test/fixtures/basic --format json --output inventory.json |
| How do I scan one TypeScript project? | node dist/cli.js . --project tsconfig.build.json |
Repeat --entry to combine entry points or --project to select multiple configs. Output files must be new. Use --strict when a partial result should set exit code 2. The CLI still produces the report.
Check diagnostics before interpreting counts. Call sites measure source occurrences. Runtime dispatch, callbacks, and external consumers can introduce paths the scanner cannot see. Review declarations with no known path before considering removal.
From an ES module in a project with the package installed:
import { scan, usages, reachability } from 'code-inventory';
// For a project with an app.ts entry and a normalize declaration:
const inventory = scan('.');
const usage = usages(inventory, 'normalize');
const paths = reachability(inventory, ['app.ts']);Open the site home from a local checkout. The guide works through the fixture and shows how to read a partial scan of the CLI. The reference covers every CLI option, scope and project selection, snapshot fields, and analysis limits.
The site is static HTML and CSS with relative links. It opens directly from disk, and the docs directory can be served as a GitHub Pages publishing source.
npm run check
osv-scanner scan source --offline -L package-lock.jsonThe project check type-checks source and tests, builds the CLI and library, runs ESLint and Vitest, and checks formatting. CI also validates its workflows with actionlint and zizmor.