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

age

Categorize pending PRs by age — new, aging, stale, or overdue.

Visual buckets help you spot neglected PRs at a glance.

When to Use

  • Morning overview: “What’s new vs. what’s been waiting?”
  • Sprint planning: “What might become overdue?”

Age Buckets

BucketAge
🆕 New0-1 days
🌱 Fresh2-3 days
⏳ Aging4-7 days
🔥 Stale8-14 days
💀 Overdue15+ days

Synopsis

prctrl age [OPTIONS]

Options

FlagDescriptionDefault
-n, --min-days <DAYS>Show only PRs newer than N days-
-x, --older-than <DAYS>Show only PRs older than N days-
-g, --groupedGroup output by age bucketfalse
-P, --priorityShow priority scores for each PR (1-5 stars)false
--repo <REPO>Filter by repository name (partial match)-
--author <AUTHOR>Filter by author username (partial match)-
--jsonOutput as JSONfalse

Examples

# Basic age overview
prctrl age

# Grouped view by bucket
prctrl age --grouped

# Show priority scores
prctrl age --priority

# Focus on older PRs
prctrl age --older-than 7
prctrl age --older-than 14 --grouped

# Filter by repo or author
prctrl age --repo myservice
prctrl age --author john