GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - Vulnetix/cli: Automate vulnerability triage which prioritizes remediation over discovery

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace
BranchesTags
Open more actions menu

Latest commit

 

History

1,492 Commits
1,492 Commits

Folders and files

NameName
Last commit message
Last commit date
.githooks
.githooks
 
 
.github
.github
 
 
.repo
.repo
 
 
.vulnetix
.vulnetix
 
 
action-lib
action-lib
 
 
ai-firewall-apply
ai-firewall-apply
 
 
aibom
aibom
 
 
analyze
analyze
 
 
api-discover
api-discover
 
 
api-upload
api-upload
 
 
attest
attest
 
 
benchmark
benchmark
 
 
bom-diff
bom-diff
 
 
bom-enrich
bom-enrich
 
 
bom-merge
bom-merge
 
 
bom-validate
bom-validate
 
 
cbom
cbom
 
 
cmd
cmd
 
 
config-apply
config-apply
 
 
config-export
config-export
 
 
config-plan
config-plan
 
 
containers
containers
 
 
deploy/sensor
deploy/sensor
 
 
docs
docs
 
 
examples
examples
 
 
fix
fix
 
 
gha-actions
gha-actions
 
 
gha-audit
gha-audit
 
 
gha-org
gha-org
 
 
gha-settings
gha-settings
 
 
gha-status
gha-status
 
 
gha-upload
gha-upload
 
 
gha-workflows
gha-workflows
 
 
github-advisories
github-advisories
 
 
github-publish
github-publish
 
 
iac
iac
 
 
ignore-sync
ignore-sync
 
 
image
image
 
 
internal
internal
 
 
jail-explain
jail-explain
 
 
jail
jail
 
 
license-exceptions-check
license-exceptions-check
 
 
license-policy-validate
license-policy-validate
 
 
license
license
 
 
malscan
malscan
 
 
package-firewall
package-firewall
 
 
pkg
pkg
 
 
report
report
 
 
sast
sast
 
 
sbom
sbom
 
 
sca
sca
 
 
scan
scan
 
 
schemas
schemas
 
 
scripts
scripts
 
 
secrets
secrets
 
 
setup
setup
 
 
surface-liveness
surface-liveness
 
 
tea-release
tea-release
 
 
terraform
terraform
 
 
test_dir
test_dir
 
 
testdata
testdata
 
 
third_party/treesitter-lua
third_party/treesitter-lua
 
 
tools
tools
 
 
triage
triage
 
 
upload
upload
 
 
vex
vex
 
 
.gitignore
.gitignore
 
 
.gitmodules
.gitmodules
 
 
.golangci.yml
.golangci.yml
 
 
AGENTS.md
AGENTS.md
 
 
Dockerfile
Dockerfile
 
 
LICENSE.md
LICENSE.md
 
 
README.md
README.md
 
 
_system.md
_system.md
 
 
action.yml
action.yml
 
 
cli.code-workspace
cli.code-workspace
 
 
flake.nix
flake.nix
 
 
go.mod
go.mod
 
 
go.sum
go.sum
 
 
install.sh
install.sh
 
 
justfile
justfile
 
 
main.go
main.go
 
 
pix.svg
pix.svg
 
 
skills-lock.json
skills-lock.json
 
 

Repository files navigation

Pix, the Vulnetix AI coding assistant

Vulnetix CLI and GitHub Action

Vulnetix scans a repository for vulnerable dependencies, code flaws, secrets, IaC and container misconfigurations, licence conflicts and malware, then tells you which findings affect the version you run and the lowest version that fixes them. It is for developers who want that answer on their own machine, and for teams who run the same scan in CI and track the results in the Resolve Platform.

Contents

  • Install
  • First scan
  • GitHub Action
  • Other CI/CD platforms
  • Pix for coding agents
  • Configuration
  • Development
  • Contributing
  • Documentation
  • License

Install

Method Platforms Command
Install script Linux, macOS curl -fsSL https://cli.vulnetix.com/install.sh | sh
Homebrew Linux, macOS brew install vulnetix/tap/vulnetix
Scoop Windows scoop bucket add vulnetix https://github.com/Vulnetix/scoop-bucket; scoop install vulnetix/vulnetix
Nix Linux, macOS nix profile install github:Vulnetix/cli
Go install All go install github.com/vulnetix/cli/v4@latest
Binary download All GitHub Releases
From source All go build -o vulnetix .

Architectures: AMD64, ARM64, ARM and 386.

The install script installs the binary only when its SHA-256 matches the release's checksums.txt, and stops when it cannot check. With cosign on PATH it also verifies the release's signed SLSA provenance; --require-provenance makes that mandatory. See docs/curl.md for the flags and for verifying a manual download.

Analytics. After a successful install, the install script sends one anonymous event to Google Analytics with the OS, architecture, CLI version and a random id made for that install. The CLI sends anonymous usage events too. Set VULNETIX_NO_ANALYTICS=1 or DO_NOT_TRACK=1 to turn both off, or pass --no-analytics to a single command.

First scan

vulnetix auth login && vulnetix scan

vulnetix auth login opens a browser to sign in. It is optional: without it, scans run in community mode on a shared quota. vulnetix scan scans the current directory. On a project whose requirements.txt pins requests==2.25.0 and jinja2==2.11.2:

Querying VDB via /v2/cli.sca: 2 unique package(s) in 1 batch(es)...
vulnetix scan: FINDINGS  9 advisories, 2 packages, 2 need action

NEEDS ACTION
  CRITICAL  jinja2 2.11.2 -> 3.1.6      CVE-2024-34064 +4   PoC-exploit   ./requirements.txt
  CRITICAL  requests 2.25.0 -> 2.33.0   CVE-2026-25645 +3   PoC-exploit   ./requirements.txt

vulnetix scan: CLEAN  no sast findings
  [OK] BOM:      ./.vulnetix/sbom.cdx.json
  [OK] Memory:   ./.vulnetix/memory.yaml

Each row is one package: the version to move to clears every advisory on it. vulnetix fix applies those upgrades and rescans, and vulnetix --help lists every command by group.

GitHub Action

name: Security scan
on: [pull_request]
permissions:
  contents: read

jobs:
  vulnetix:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: Vulnetix/cli@v4
        with:
          task: sca
          org-id: ${{ secrets.VULNETIX_ORG_ID }}
          api-key: ${{ secrets.VULNETIX_API_KEY }}

@v4 installs the newest v4 release. The action checks the binary's SHA-256 and, by default, installs cosign and verifies the release's signed provenance (verify-provenance: true).

To upload a report you already have:

- uses: Vulnetix/cli@v4
  with:
    org-id: ${{ secrets.VULNETIX_ORG_ID }}
    api-key: ${{ secrets.VULNETIX_API_KEY }}
    task: upload
    upload-file: ./reports/results.sarif

The task input takes:

Task What it runs
info Authentication healthcheck (the default)
sca Scan dependencies for known vulnerabilities
sast Scan source code with the SAST rules
secrets Scan for committed secrets
iac Scan infrastructure as code
containers Scan container files and images
license Evaluate dependency licences against the licence policy
malscan Scan installed dependencies for malicious code
analyze Report the repository's tech stack, ownership and risk
sbom Write a CycloneDX SBOM
cbom Write a cryptography bill of materials
aibom Write an AI bill of materials
jail Assess the repository against the organisation's jail policy
upload Upload one artifact file to Vulnetix
gha Upload every artifact of this workflow run to Vulnetix
tea-release Publish a release and its artifacts to the Transparency Exchange API
config-plan Plan Platform IaC documents and comment the plan on the pull request
config-apply Apply Platform IaC documents

Most tasks also have their own action, such as Vulnetix/cli/sca@v4, with artifact, attestation and release steps. See docs/github-actions.md for every input and docs/GHA_COMMAND.md for uploading workflow artifacts.

Other CI/CD platforms

Platform Guide
GitLab CI docs/gitlab-ci.md
Azure DevOps docs/azure-devops.md
Bitbucket docs/bitbucket.md

Pix for coding agents

Pix wires Vulnetix into the coding agents on your machine (Claude Code, Codex and others): hooks that check a dependency before it lands and a commit before it records a credential, and skills for work that needs your working tree, such as fixing a finding and checking the fix landed.

vulnetix agent install

It detects the agents, writes each one's hook config and skills, and configures the Vulnetix MCP server where the agent speaks MCP. In Claude Code you can install the plugin instead:

/plugin marketplace add Vulnetix/pix-ai-coding-assistant
/plugin install vulnetix@vulnetix-plugins

See the Pix documentation and the Pix repository.

Configuration

Where What
~/.vulnetix/credentials.json Credentials from vulnetix auth login (the default --store home)
.vulnetix/credentials.json Project credentials, with vulnetix auth login --store project
.vulnetix/config/ Platform IaC documents for vulnetix config plan and apply, VEX sources and licence exceptions (docs/platform-iac.md)
.vulnetix/memory.yaml, .vulnetix/sbom.cdx.json What the last scan found; vulnetix report reads them without rescanning
VULNETIX_ORG_ID, VULNETIX_API_KEY, VULNETIX_API_TOKEN Credentials from the environment, read before any file
VULNETIX_NO_ANALYTICS, DO_NOT_TRACK Turn off anonymous usage analytics

Development

go build -o vulnetix .
just test

just test runs go test ./.... Go 1.25 or newer is required (see go.mod). The justfile lists the other recipes, including the generators for docs and actions.

Contributing

Open an issue or a pull request at github.com/Vulnetix/cli. Run just test before you send a change, and regenerate any generated file you touch (the justfile and AGENTS.md say which).

Documentation

  • CLI documentation
  • Pix documentation
  • VDB API
  • Installation guides
  • Distribution
  • GitHub App

License

AGPL-3.0

About

Automate vulnerability triage which prioritizes remediation over discovery

www.vulnetix.com

Topics

cyclonedxoscalsarifsastsbomscaslsasoftware-transparencyspdxvexvulnerability-management

Resources

Readme
License
Activity
Custom properties

Stars

25 stars

Watchers

2 watching

Forks

1 fork
Report repository

Used by

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.