Skip to content
This repository was archived by the owner on Jan 22, 2026. It is now read-only.

Latest commit

 

History

History
95 lines (67 loc) · 1.48 KB

File metadata and controls

95 lines (67 loc) · 1.48 KB

Quick Start

Setup

cd your-project
git pkgs init

Basic Commands

# Show current dependencies
git pkgs list

# Filter by manifest
git pkgs list --manifest=Gemfile

# Show dependencies at a specific point in time
git pkgs list january-2025

# Show dependency changes in HEAD commit
git pkgs show

# Compare dependencies between refs
git pkgs diff --from=HEAD~10
git pkgs diff --from=january-2025

History and Blame

# History of a specific package
git pkgs history rails

# All dependency changes by an author
git pkgs history --author=Andrew

# Find where a package is declared
git pkgs where dotenv-rails

Package Health

# Find outdated packages
git pkgs outdated

# Show licenses with compliance check
git pkgs licenses
git pkgs licenses --permissive

Vulnerability Scanning

# Show commits that introduced or fixed vulnerabilities
git pkgs vulns log

# Show who introduced vulnerabilities
git pkgs vulns blame

# Show who fixed vulnerabilities
git pkgs vulns praise

# Show exposure metrics over all time
git pkgs vulns exposure --all-time

SBOM Export

# Export as CycloneDX (default)
git pkgs sbom > sbom.json

# Export as SPDX
git pkgs sbom --type=spdx

Git Integration

# Install diff driver for semantic lockfile diffs
git pkgs diff-driver --install

# Now git diff shows dependency changes
git diff HEAD~5 -- Gemfile.lock

Database Schema

# Show database schema
git pkgs schema