bivvy lint

Validates your Bivvy configuration without executing anything.

Usage

bivvy lint                 # Human-readable output
bivvy lint --format=json   # JSON output
bivvy lint --format=sarif  # SARIF for IDE integration
bivvy lint --fix           # Auto-fix simple issues
bivvy lint --strict        # Treat warnings as errors

Exit Codes

Code	Meaning
0	No errors (warnings OK)
1	Errors found
2	No configuration found

With --strict, warnings also cause exit code 1.

Example Output

Valid Configuration

Configuration is valid!

Invalid Configuration

error [default]: Workflow references unknown step 'nonexistent'

Found 1 error(s)

Integration

VS Code

Use the SARIF Viewer extension:

bivvy lint --format=sarif > bivvy.sarif

GitHub Actions

- name: Lint Bivvy config
  run: bivvy lint --format=sarif > bivvy.sarif
- uses: github/codeql-action/upload-sarif@v2
  with:
    sarif_file: bivvy.sarif