# 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

```bash
prctrl catchup [OPTIONS]
```

## Options

| Flag | Description | Default |
|------|-------------|---------|
| `PR_NUMBER` | PR 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 shown | `10` |
| `-P, --priority` | Show 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, --all` | Show all neglected PRs without limit | `false` |
| `--json` | Output as JSON | `false` |

## Examples

```bash
# 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
```
