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

catchup

Show PRs you should catch up on — oldest, longest-ignored, sorted by neglect.

Perfect for after vacation or when returning to a busy sprint.

When to Use

  • Back from vacation: “What did I miss?”
  • Weekly review: “What have I been neglecting?”

Synopsis

prctrl catchup [OPTIONS]

Options

FlagDescriptionDefault
PR_NUMBERPR number to show catchup for (shorthand for --pr)
--min-age <DAYS>Minimum age in days to be considered “catchup”3
-n, --limit <NUM>Limit the number of results shown10
-P, --priorityShow priority scores (1-5 stars based on age and size)false
--repo <PATTERN>Filter by repository name (partial match, case-insensitive)
--author <PATTERN>Filter by author username (partial match, case-insensitive)
-s, --since-days <DAYS>Only show PRs created since this many days ago-
-a, --allShow all neglected PRs without limitfalse
--jsonOutput as JSONfalse

Examples

# Show PRs older than 3 days
prctrl catchup

# Focus on week-old+ PRs
prctrl catchup --min-age 7

# Show priority scores for each PR
prctrl catchup --priority

# Show only PRs created in the last 14 days but older than 3 days
prctrl catchup --since-days 14 --min-age 3

# Combine with limit for more results
prctrl catchup --min-age 7 --limit 20

# Filter by repository
prctrl catchup --repo myservice

# Filter by author
prctrl catchup --author johndoe

# Show ALL neglected PRs without truncation
prctrl catchup --all

# Combine filters for targeted catchup
prctrl catchup --min-age 7 --repo api --author johndoe --priority

# Target a specific PR (bypasses --min-age filter)
prctrl catchup --pr 123
prctrl catchup 123