gh-velocity report#

Composite dashboard of velocity and quality metrics

Synopsis#

Show a trailing-window report composing lead time, cycle time, throughput, work in progress, and quality metrics.

Default window is the last 30 days. Use --since and --until to customize.

Each section computes independently; a failure in one section does not block others. Sections that require specific config (WIP needs project.id or active_labels; quality needs releases) are gracefully omitted when unavailable.

gh-velocity report [flags]

Examples#

  # Default: last 30 days
  gh velocity report

  # Custom window
  gh velocity report --since 14d --until 2026-03-01

  # Remote repo, JSON for CI dashboards
  gh velocity report --since 30d -R cli/cli -f json

Options#

  -h, --help           help for report
      --since string   Start of date window (default: 30d)
      --until string   End of date window (default: now)

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 - GitHub velocity and quality metrics