trends

Analyze your review trends over time — velocity, week-over-week changes, top authors.

See how your review patterns evolve. How fast are you reviewing? Is your backlog growing or shrinking? Who’s sending the most PRs your way?

When to Use

End-of-sprint check: “Am I keeping up with reviews?”
Personal metrics: track your review velocity over time
Team health: spot if backlog is growing

Synopsis

prctrl trends [OPTIONS]

Options

Flag	Description	Default
`-d, --days <NUM>`	Number of days to look back	`30`
`-n, --limit <NUM>`	Number of top authors/repos to show	`10`
`--repo <PATTERN>`	Filter by repository name (partial match, case-insensitive)
`--author <PATTERN>`	Filter by author username (partial match, case-insensitive)
`-P, --priority`	Show priority scores (1-5 stars) for top reviewed PRs	`false`
`--json`	Output as JSON for scripting	`false`
`-s, --since-days <NUM>`	Only show PRs created since this many days ago
`-p, --pr <NUM>`	Target a specific PR by number (global flag, available on all commands)

Examples

# Standard 30-day trend analysis
prctrl trends

# Quick 7-day snapshot
prctrl trends --days 7

# Focus on top 5 authors/repos
prctrl trends --limit 5

# Filter by repository
prctrl trends --repo frontend

# Filter by author
prctrl trends --author alice

# Combine filters
prctrl trends --repo backend --author bob

# Only show recent PRs (created in last 7 days)
prctrl trends --since-days 7

# Combine filters with since-days
prctrl trends --repo frontend --since-days 14

# JSON for dashboards/scripts
prctrl trends --json | jq '.avg_per_day'

# Show top PRs by priority score
prctrl trends --priority

# Show trends for a specific PR
prctrl trends --pr 123

Output Example

📈 Review Trends — last 30 days

  📊 Summary
     Total reviews:       47
     Daily average:      1.6 PRs/day
     Lines reviewed:     +2840 / -1230
     Avg PR size:        +60 / -26

  📅 Week-over-Week
     📈 This week: 12   Previous: 9   Change: +33.3%

  📈 Daily Activity (last 14 days)
     03-21  ████████░░░░░░░░░░░░░  8
     03-22  ██████████████░░░░░░░  12
     ...

  👥 Top Authors (by PR count)
     alice      14
     bob        11
     carol       9

  📁 Top Repositories
     frontend    18
     backend    15
     shared      8

  ⭐ Top PRs by Priority
     ⭐⭐⭐⭐⭐  #234  Bug fix in auth middleware (frontend)
     ⭐⭐⭐⭐⭐  #189  Refactor database layer (backend)
     ⭐⭐⭐⭐   #201  Update API documentation (shared)

Trends reads the processed review files saved in your output directory (default: ./reviews/). Each review file contains metadata about when it was reviewed, who authored it, and how large it was — trends aggregates this data to surface patterns.

The week-over-week comparison tells you if your review throughput is increasing or decreasing. The sparkline chart gives you a visual feel for daily rhythm — are you batch-reviewing on certain days?

Tips

Requires review files from delegate command (run prctrl delegate first to generate them)
Use --days 7 for a tight weekly view, --days 90 for quarterly context
Pipe to jq for integration with monitoring dashboards

PRCtrl