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

# unassign

**Remove yourself as a reviewer from a PR.**

The counterpart to `assign` — give up review responsibility when you've been assigned by mistake or the author should have asked someone else.

## When to Use

- Wrong assignment: "I was asked to review this by accident"
- Capacity shift: "I'm too busy, someone else should take this"
- Triage cleanup: Clean up your review queue after re-organizing
- Batch operation: Use `--all` to unassign from all pending reviews at once
- Scripting: Use `--json` for programmatic integrations

## Synopsis

```bash
prctrl unassign [OPTIONS] [PR_NUMBER]
```

## Options

| Flag | Description | Default |
|------|-------------|---------|
| `PR_NUMBER` | PR number to unassign yourself from (shorthand for `--pr`) | Required if no `--pr` |
| `-p, --pr` | Global flag: target a specific PR number | - |
| `-a, --all` | Unassign yourself from all pending reviews at once | `false` |
| `-n, --pr-numbers` | PR number(s) to unassign from (comma-separated, e.g. `123,456`) | - |
| `-s, --since-days` | Only show PRs created since this many days ago | - |
| `-n, --dry-run` | Preview what would be unassigned without actually removing | `false` |
| `--json` | Output as JSON for scripting | `false` |
| `-q, --quiet` | Suppress per-PR progress messages (show only summary) | `false` |
| `--repo` | Filter by repository name (partial match, case-insensitive) | - |
| `--author` | Filter by author username (partial match, case-insensitive) | - |
| `-P, --priority` | Show priority scores for each PR (1-5 stars based on age and size) | `false` |

## Examples

```bash
# Unassign from a specific PR
prctrl unassign 4821

# Preview what would be unassigned (dry-run)
prctrl unassign --all --dry-run

# Unassign from all pending reviews at once
prctrl unassign --all

# Unassign from multiple specific PRs
prctrl unassign --pr-numbers 4821,4822,4823

# Interactive selection from pending reviews
prctrl unassign

# Unassign with JSON output (for scripting)
prctrl unassign 4821 --json

# Unassign from all PRs created in the last 3 days
prctrl unassign --all --since-days 3

# Unassign with priority scores shown
prctrl unassign --priority
```

## Tips

- Use `--all` to quickly unassign yourself from ALL pending reviews without prompting
- Use `--pr-numbers` to unassign from multiple specific PRs in one command
- Use `--dry-run` to preview what would be unassigned before making changes
- Parallel requests are used when unassigning from multiple PRs for speed
- If no PR number is provided and `--all` is not used, shows your pending reviews and lets you select interactively

## JSON Output

When `--json` is used, returns an array of results:

```json
[
  {
    "pr_number": 4821,
    "pr_title": "Add user authentication",
    "repo": "myorg/myrepo",
    "url": "https://github.com/myorg/myrepo/pull/4821",
    "success": true,
    "error": null
  }
]
```