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
- Reads the
.snoozed.jsonfile from your output directory - Checks each entry’s
snoozed_untiltimestamp against the current time - Removes entries where the snooze period has passed
- Saves the updated list back to
.snoozed.json - Reports how many entries were cleaned and how many remain
Relationship to Other Commands
| Command | Purpose |
|---|---|
snooze add | Add PRs to the snooze list |
snooze list | Show currently snoozed PRs with time remaining |
snooze remove | Manually remove specific PRs from snooze |
snooze clear | Remove ALL snoozed PRs at once |
snooze expire | Automatically remove PRs whose snooze has elapsed |
Tips
- Run
snooze expirebeforelistto see all PRs including recently snoozed ones that have expired - For automation, add
snooze expireto your daily review script before fetching pending reviews - Snoozed PRs are hidden from
listbut don’t automatically reappear — useexpireto restore them