Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

files

Show changed files for one or more PRs.

Quickly see which files were modified before diving into the diff.

When to Use

  • Pre-review scan: “What did they change?”
  • Impact assessment: “Which services are affected?”

Synopsis

prctrl files [OPTIONS] [PR_NUMBER]

Options

FlagDescriptionDefault
PR_NUMBERPR number to show files for (shorthand for --pr)-
-p, --pr <PR>Show files for specific PR (bypasses snooze exclusion)-
--pr-numbers <NUMS>PR number(s) to show files for (comma-separated)-
-a, --allShow files for all pending reviewsfalse
-P, --priorityShow priority scores for each PR (1-5 stars)false
--jsonOutput as JSON (useful for scripting)false
--repo <REPO>Filter by repository name (partial match, case-insensitive)-
--author <USER>Filter by author username (partial match, case-insensitive)-
-s, --since-days <DAYS>Only show PRs created since this many days ago-

Examples

# Show files for a specific PR
prctrl files 4821
prctrl files --pr 4821

# Show files for multiple PRs
prctrl files --pr-numbers 4821,3156,2890

# Show files for all pending reviews
prctrl files --all

# Filter by repository
prctrl files --all --repo myservice

# Filter by author
prctrl files --all --author johndoe

# Combined filters
prctrl files --all --repo api --priority

# Only show files for recent PRs (last 7 days)
prctrl files --all --since-days 7

# JSON output for scripting
prctrl files --pr 4821 --json

JSON Output

When --json is specified, output includes for each PR:

  • pr_number, pr_title, repo, url
  • total_files, total_additions, total_deletions
  • files[] - array of file objects with filename, status, additions, deletions

Notes

  • Snoozed PRs are automatically excluded when using --all or interactive selection (consistent with search, top, delegate, and list commands)
  • Use --pr to bypass snooze exclusion and view files for a specific snoozed PR