gh-velocity flow#
Flow metrics (lead-time, cycle-time, velocity)
Synopsis#
How fast is work flowing through your team?
Flow metrics measure the speed and volume of work:
lead-time Total time from issue creation to closure cycle-time Active work time (start signal to close/merge) throughput Items completed per time window velocity Effort delivered per iteration
Options#
-h, --help help for flowOptions inherited from parent commands#
--config string Path to config file (default: .gh-velocity.yml)
--debug Print diagnostic info to stderr
--new-post Force a new post (skip idempotent update; implies --post)
--no-cache Disable disk cache (in-memory deduplication still active)
--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
-r, --results strings Output format(s): json, pretty, markdown, html (comma-separated) (default [pretty])
--scope string Additional GitHub search qualifier(s) ANDed with config scope
--title string Override discussion title (with --post)
--write-to string Write result files to this directory (silences stdout)SEE ALSO#
- gh-velocity - GitHub velocity and quality metrics
- gh-velocity flow cycle-time - Cycle time for an issue, PR, or bulk query
- gh-velocity flow lead-time - Lead time for an issue or bulk query (created → closed)
- gh-velocity flow throughput - Count issues closed and PRs merged in a window
- gh-velocity flow velocity - Measure effort completed per iteration (sprint velocity)