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

snooze expire

Remove expired snooze entries and restore PRs to your pending list.

Automatically clean up snoozed PRs whose snooze duration has elapsed. Expired entries are permanently removed from the snooze list, making those PRs visible again in your pending reviews.

When to Use

  • Routine maintenance: Run periodically to keep your snooze list clean
  • After returning from vacation: Clean up old snoozes you forgot about
  • As part of a daily/weekly script: Automate cleanup alongside other review tasks

Synopsis

prctrl snooze expire

Options

This subcommand has no additional flags.

Examples

# Clean up all expired snooze entries
prctrl snooze expire

# Expected output (when there are expired entries):
# 🧹 Cleaned up 3 expired snooze entry(s):
#   ✨ Fix authentication bug #456 (myorg/myrepo)
#   ✨ Update dependencies #789 (myorg/other-repo)
#   ✨ Add user dashboard #101 (myorg/myrepo)
#
#   ↩️ 3 PR(s) have returned to your pending list.
# ✅ 7 snoozed PR(s) remain in the list.

# Expected output (when nothing has expired):
# ✨ No expired snooze entries to clean up.

How It Works

  1. Reads the .snoozed.json file from your output directory
  2. Checks each entry’s snoozed_until timestamp against the current time
  3. Removes entries where the snooze period has passed
  4. Saves the updated list back to .snoozed.json
  5. Reports how many entries were cleaned and how many remain

Relationship to Other Commands

CommandPurpose
snooze addAdd PRs to the snooze list
snooze listShow currently snoozed PRs with time remaining
snooze removeManually remove specific PRs from snooze
snooze clearRemove ALL snoozed PRs at once
snooze expireAutomatically remove PRs whose snooze has elapsed

Tips

  • Run snooze expire before list to see all PRs including recently snoozed ones that have expired
  • For automation, add snooze expire to your daily review script before fetching pending reviews
  • Snoozed PRs are hidden from list but don’t automatically reappear — use expire to restore them