VibeGuard GitHub Action

May 28, 2026 ยท View on GitHub

The dgenio/vibeguard action runs VibeGuard as a composite GitHub Action step.

Usage

- uses: dgenio/vibeguard@v0.8.0
  with:
    path: '.'
    diff: 'true'
    fail-on: 'high'
    output-format: 'sarif'
    output-file: 'vibeguard.sarif'

Inputs

InputRequiredDefaultDescription
pathNo.Directory to scan
configNo``Path to vibeguard.yaml
diffNofalseScan only changed files
fail-onNohighSeverity threshold for gate failure
output-formatNoconsoleconsole, json, markdown, sarif, pr-comment
output-fileNo``Write output to this file path
baselineNo``Path to baseline file
python-versionNo3.11Python version to use

Outputs

OutputDescription
findings-countTotal number of findings
blocking-countNumber of findings at or above fail-on threshold
report-pathPath to the output file (if output-file was set)
gate-passedtrue or false

Complete Example

name: VibeGuard
on: [pull_request]

permissions:
  contents: read
  security-events: write

jobs:
  vibeguard:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - uses: dgenio/vibeguard@v0.8.0
        id: vibeguard
        with:
          diff: 'true'
          fail-on: 'high'
          output-format: 'sarif'
          output-file: 'vibeguard.sarif'

      - name: Upload SARIF
        if: always()
        uses: github/codeql-action/upload-sarif@v3
        with:
          sarif_file: vibeguard.sarif