snyk-delta is a command-line interface tool designed to identify and report only *newly introduced* security vulnerabilities, license issues, and code findings in Snyk projects. It functions by comparing a current Snyk scan snapshot against a predefined baseline snapshot, making it particularly useful for integration into CI/CD pipelines, pre-commit hooks, or local development workflows where only changes since a previous state are of interest. The tool is currently at version 1.13.2 and is in maintenance mode, meaning new features are not being actively developed, though bug fixes and security patches continue to be released. Key differentiators include its ability to filter out pre-existing issues, focus on dependency changes (added/removed direct and indirect dependencies), and provide specific exit codes for automated decision-making in build systems. It supports Snyk Open Source, Container, and Code (with specific feature requirements), but not IaC.
npm install snyk-deltaVerified import paths — ran on the pinned version, not inferred.
Demonstrates programmatic usage of `getCodeDelta` to compare two local SARIF files, illustrating how to identify new Snyk Code findings and exit with appropriate status codes based on the comparison result. Requires `SNYK_TOKEN` and `SNYK_ORG_ID`.
Be aware that the tool's functionality will remain stable, but new capabilities aligning with future Snyk product developments may not be implemented directly within this tool.
Ensure your Snyk account is at the Business or Enterprise tier. Refer to Snyk documentation for account plan details and feature parity.
Set the `SNYK_TOKEN` environment variable in your environment (e.g., `export SNYK_TOKEN=your-token`) before running `snyk-delta`. Obtain a service account token for CI/CD environments for enhanced security and manageability.
Do not use `snyk-delta` for Snyk IaC projects. This tool is specifically designed for Open Source, Container, and Code findings. Consider alternative methods for delta comparison of IaC findings if available within the Snyk platform.
Verify and enable the 'Code Consistent Ignores' feature in your Snyk organization settings. Consult Snyk documentation for instructions on feature enablement and its impact on Snyk Code scans.
Set `SNYK_TOKEN` (e.g., `export SNYK_TOKEN="your_snyk_api_token"`) in your shell or CI/CD environment before executing `snyk-delta`.
Double-check the Snyk Organization and Project IDs for accuracy. Ensure the provided `SNYK_TOKEN` has the required read permissions for the specified resources.
Enable 'Code Consistent Ignores' in your Snyk Organization settings. Refer to Snyk documentation or contact Snyk support for assistance in enabling this feature.
Refrain from using `snyk-delta` for IaC projects. This tool's functionality is limited to Open Source, Container, and Code vulnerability types.
No dependency data recorded yet.