Skip to content

show approval-comments

Home › Reference › Commands › Show › Approval Comments

show approval-comments - Display PR approval comments in human-readable format

Display PR review approvals for specification-related PRs merged in a release.

Shows approvals from GitHub PRs that contain .feature specification files. Special keywords: "unreleased" for pending PRs, "latest" for most recent release.

By default, only shows APPROVED reviews. Use --include-all-reviews to see all review states.

Flags

Flag Description
--include-all-reviews Include all review states (not just APPROVED)
--branch Branch to query (default: trunk branch from config, usually "main"). Use "HEAD" for current branch

Notes

Expected Output:

  • Header with module and version
  • Summary line with PR and approval counts
  • Markdown table with columns: PR, Title, Reviewer, Review State, Reviewed At

Examples

show approval-comments ext-eac
show approval-comments ext-eac latest
show approval-comments ext-eac unreleased
show approval-comments ext-eac --include-all-reviews

Bundle Modules

For container/bundle modules with dependencies, approvals are aggregated from all dependent modules.

Example: When querying ext-eac (which depends on eac-commands and r2r-cli):

r2r eac show approval-comments ext-eac

Shows approvals from PRs containing:

  • specs/eac-commands/ (dependency)
  • specs/r2r-cli/ (dependency)
  • specs/ext-eac/ (if any)

Regular modules only show approvals from their own specs/<module>/ directory.

How It Works

  1. Scans git commits for PR references (#123 or Merge pull request #123)
  2. Fetches PR data via GitHub CLI (gh pr view)
  3. Filters to PRs containing .feature files in specs/<module>/
  4. Extracts reviews (APPROVED by default, use --include-all-reviews for all states)

Requirements

  • GitHub CLI (gh): Command degrades gracefully if unavailable
  • Authentication: gh auth login required

Troubleshooting

No Approvals Shown

Possible causes:

  • No PRs merged in the version range
  • PRs don't contain .feature files
  • No APPROVED reviews (try --include-all-reviews)
  • GitHub CLI unavailable

gh Command Failed

# Install and authenticate GitHub CLI
gh auth login

See Also

Tutorials | How-to Guides | Explanation | Reference

You are here: Reference — information-oriented technical descriptions of the system.