watchdep / Install
Install.
Two pieces you run, and one we run. The CLI alone is enough to fail a build on what is exploited now. The hosted service adds one view across applications, alerts and the decision record.
The CLI
Releases are one static binary per platform (Linux, macOS and Windows, on amd64 and arm64) with a checksums file, on the releases page. The latest is 0.1.0. Download the archive for your platform and checksums.txt, check it and put watchdep on your path (Linux amd64 here; darwin_arm64 for an Apple silicon Mac, shasum -a 256 -c on macOS):
v=0.1.0
curl -fsSLO "https://github.com/kimathinjoki/watchdep-cli/releases/download/v$v/watchdep_${v}_linux_amd64.tar.gz"
curl -fsSLO "https://github.com/kimathinjoki/watchdep-cli/releases/download/v$v/checksums.txt"
sha256sum --check --ignore-missing checksums.txt
tar -xzf "watchdep_${v}_linux_amd64.tar.gz" watchdep
./watchdep versionOr build it from source with Go 1.27 or later: git clone https://github.com/kimathinjoki/watchdep-cli && make -C watchdep-cli build writes watchdep-cli/bin/watchdep.
Then, in any project:
watchdep gateIt takes the inventory, checks it against OSV, CISA KEV and EPSS, and exits 1 when a finding meets the threshold (by default: exploited now, or a malicious release), 2 when it could not look at everything. Every command and flag: the CLI reference.
The hosted service
The hosted service keeps one finding per advisory per application until a person decides it, alerts the right people, and records every decision in a log that cannot be edited.
Sign up with your email and a password: you get your own workspace and are its owner.
Then, per application, add its parts, create a part's token, and where the code is:
export WATCHDEP_SERVER=https://watchdep.example.com # the service's address
export WATCHDEP_TOKEN=wdp_...
watchdep scanOnly the inventory leaves the machine; the code never does. How it works: The hosted service. Reading repositories without the CLI: Connecting GitHub.
The GitHub Action
- uses: actions/checkout@v4
- uses: kimathinjoki/watchdep-action@18cbad45072956cbc9c9442b8dffe9e315934499 # v1, pinned by commit SHA
with:
version: 0.1.0
command: gate
args: --fail-on malicious,kev,severeIt installs a pinned CLI release, verifies its SHA-256 against the checksums committed in the Action, and runs scan, check, fix, gate or deployed. Workflows for each: The Action and CI.