gh-velocity config validate#

Validate configuration and report errors

Synopsis#

Validate a .gh-velocity.yml file and report any errors.

Checks include: YAML syntax, known top-level keys, matcher syntax (label:, type:, title:, field: patterns), project URL format, numeric ranges (e.g., hotfix_window_hours), and category name requirements.

Use --velocity to additionally verify that velocity-specific config (effort strategy, iteration strategy, project field names) is correctly configured against your actual GitHub project board.

This command does not make API calls (except with --velocity, which queries the project board to validate field names).

gh-velocity config validate [flags]

Examples#

  gh velocity config validate
  gh velocity config validate --velocity

Options#

  -h, --help       help for validate
      --velocity   Live-test velocity matchers against recent issues

Options inherited from parent commands#

      --config string   Path to config file (default: .gh-velocity.yml)
      --debug           Print diagnostic info to stderr
  -f, --format string   Output format: json, pretty, markdown (default "pretty")
      --new-post        Force a new post (skip idempotent update; implies --post)
      --post            Post output to GitHub (dry-run by default; set GH_VELOCITY_POST_LIVE=true for live)
  -R, --repo string     Repository in owner/name format
      --scope string    Additional GitHub search qualifier(s) ANDed with config scope

SEE ALSO#

• gh-velocity config - Inspect, validate, and generate configuration