gh fleet status

Show every target's PR, state, checks, reviews and last error

Synopsis

Refresh every target's PR from GitHub, in one batched GraphQL query per 50 repos, and print a table with the PR link, state, check rollup, review decision and the last error recorded locally.

GitHub is the source of truth: PRs are found by branch and by the hidden campaign marker, so status is correct even after the local state file is deleted. The remaining API quota is shown at the end.

--exit-status sets the exit code from the result, for scripts and CI: 1 if a repo failed, 8 while any still needs work, and 0 once every repo is merged, closed, a no-op or skipped.

--format markdown prints a progress report to paste into an issue, a PR or chat: what needs attention, open PRs and what each waits on, and merged PRs. --format html prints the same report as a self-contained page.

gh fleet status [campaign] [flags]

Examples

  gh fleet status
  gh fleet status pin-actions --json counts --jq '.counts'
  gh fleet status --exit-status && echo "every PR is merged"
  gh fleet status --format markdown | gh issue comment 42 --body-file -
  gh fleet status --format html > report.html

Options

      --concurrency int        repos cloned and run in parallel (default limits.concurrency, else 16)
      --exclude strings        leave out these repos (owner/name, repeatable)
      --exclude-file strings   leave out the repos listed in this file, one per line (- for stdin, repeatable)
      --exit-status            exit 1 if a repo failed, or 8 while repos still need work
  -f, --file string            campaign file (default ./fleet.yaml)
      --format string          table, or a report to share: markdown or html (default "table")
  -h, --help                   help for status
  -q, --jq expression          filter JSON output using a jq expression
      --json fields            output JSON with the specified fields (comma-separated; --json alone lists them)
      --repo strings           limit to these repos (owner/name, repeatable)
      --repo-file strings      limit to the repos listed in this file, one per line (- for stdin, repeatable)
  -t, --template string        format JSON output using a Go template; see gh help formatting
      --write-rate float       GitHub API writes per second (default 1)

Options inherited from parent commands

      --config string   config file (default $XDG_CONFIG_HOME/gh-fleet/config.yaml)
      --debug           log what gh fleet is doing and print how long each part took

SEE ALSO

• gh fleet - Apply one change across many repositories and track the PRs