prctrl 2.1.0

Terminal-native GitHub PR management. Stay on top of code reviews without leaving your terminal.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130

# snooze

**Temporarily hide PRs from the pending list.**

Snooze PRs you're not ready to review yet.

## When to Use

- Context overload: "Not now, remind me later"
- Vacation: "Hide until I return"

## Synopsis

```bash
prctrl snooze [OPTIONS] [PR_NUMBER] [PR_NUMBERS]
```

## Options

| Flag | Description | Default |
|------|-------------|---------|
| `PR_NUMBER` | PR number to snooze (shorthand for --pr) | `none` |
| `-p, --pr <NUM>` | Snooze specific PR | `none` |
| `PR_NUMBERS` | PR number(s) to snooze (comma-separated) | `none` |
| `-d, --days <NUM>` | Days to snooze | `3` |
| `-s, --since-days <NUM>` | Only show PRs created since this many days ago | `none` |
| `--json` | Output as JSON (useful for scripting) | `false` |
| `-P, --priority` | Show priority scores for listed snoozed PRs | `false` |
| `--repo <PATTERN>` | Filter by repository name (partial match, case-insensitive) | `none` |
| `--author <PATTERN>` | Filter by author username (partial match, case-insensitive) | `none` |

## Subcommands

### list

List all currently snoozed PRs.

```bash
prctrl snooze list
prctrl snooze list --repo myrepo
prctrl snooze list --author johndoe
prctrl snooze list --repo myrepo --author johndoe
```

### review

Show detailed view of snoozed PRs with full metadata.

```bash
prctrl snooze review
prctrl snooze review --repo myrepo
```

### add

Add PR(s) to the snooze list. When using interactive selection (no PR specified), `--repo` and `--author` filters are applied to narrow down the list of pending reviews shown.

```bash
prctrl snooze add 4821
prctrl snooze 4821 --days 7
prctrl snooze add 4821,4822,4823
prctrl snooze add --repo myservice --author johndoe
```

### remove

Remove PR(s) from the snooze list (wake them up).

```bash
prctrl snooze remove 4821
prctrl snooze remove --pr 4821
prctrl snooze remove 4821,4822,4823
```

### clear

Clear all snoozed PRs.

```bash
prctrl snooze clear
```

### expire

Remove expired snooze entries.

```bash
prctrl snooze expire
```

### extend

Extend snooze duration for already-snoozed PRs.

```bash
prctrl snooze extend 4821 --days 7
prctrl snooze extend --pr 4821 --days 7
prctrl snooze extend 4821,4822,4823 --days 5
```

## Examples

```bash
# Snooze a single PR for 3 days (using positional argument)
prctrl snooze 4821

# Snooze a single PR using --pr flag
prctrl snooze add --pr 4821

# Snooze for 7 days
prctrl snooze 4821 --days 7

# Snooze all PRs from the last 2 weeks (interactive selection)
prctrl snooze add --since-days 14

# List snoozed PRs as JSON (for scripting)
prctrl snooze list --json

# List snoozed PRs with priority scores
prctrl snooze list --priority

# List snoozed PRs filtered by repository
prctrl snooze list --repo myrepo

# List snoozed PRs filtered by author
prctrl snooze list --author johndoe

# Show detailed view filtered by repo
prctrl snooze review --repo myrepo
```