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

# mine

**List your own open PRs — draft or not.**

Track your own pull requests from the command line.

## When to Use

- Status check: "What's my open PRs?"
- Draft management: "Find all my draft PRs"

## Synopsis

```bash
prctrl mine [flags]
```

## Flags

- `--json` — Output as JSON (useful for scripting)
- `-a, --all` — Show all matching PRs at once (without prompting)
- `-P, --priority` — Show priority score (1-5 stars) based on age and size
- `-s, --since-days <DAYS>` — Only show PRs created since this many days ago
- `--repo <REPO>` — Filter by repository name (partial match, case-insensitive)
- `--author <AUTHOR>` — Filter by author username (partial match, case-insensitive)
- `-p, --pr <PR_NUMBER>` — Target a specific PR by number
- `--pr-numbers <NUMBERS>` — Target multiple PRs by number (comma-separated, e.g., `123,456,789`)

## Stack Detection

The `mine` command automatically detects and displays **stacked PRs** — PRs that build on each other. Stacks are shown after your individual PR list.

### Detection methods

PRCtrl uses two methods to detect stacked PRs:

**1. Branch chaining** — A PR's base branch is another PR's head branch:
- PR A: `feature` → `main`
- PR B: `feature-2` → `feature`
- This creates a stack: PR A → PR B

**2. Convention** — PRs sharing the same ticket key with `[N/M]` position markers:
- PR #1: `refactor(TAHC-1666): add client [1/3]` on branch `TAHC-1666-client`
- PR #2: `refactor(TAHC-1666): add service [2/3]` on branch `TAHC-1666-service`
- PR #3: `refactor(TAHC-1666): add tests [3/3]` on branch `TAHC-1666-tests`
- These are grouped into a stack by the `TAHC-1666` ticket key

Example stack output:
```
┌─ Stack on `main` (3 PRs, branch-chain)

🔵 [1/3] #974 - refactor(TAHC-1666): extract OnboardingCmsClient port [1/3] [DRAFT]
  └─ TAHC-1666-onboarding-cms-client-port
    https://github.com/doctolib/health-content/pull/974

  [2/3] #975 - refactor(TAHC-1666): extract OnboardingCompletionChecker port [2/3] [DRAFT]
  └─ TAHC-1666-onboarding-completion-checker
    https://github.com/doctolib/health-content/pull/975

  [3/3] #976 - refactor(TAHC-1666): extract OnboardingDebugController [3/3] [DRAFT]
  └─ TAHC-1666-onboarding-debug-controller
    https://github.com/doctolib/health-content/pull/976
```

## Global Flags

These flags are available globally and work with `mine`:

- `-p, --pr <PR_NUMBER>` — Target a specific PR by number (overrides filters)
- `-d, --include-drafts` — Include draft PRs in results
- `--exclude-prefix <PREFIXES>` — Exclude PRs with matching title prefixes (comma-separated)
- `-o, --output-dir <PATH>` — Folder for review files (default: ./reviews)

## Snooze Behavior

Snoozed PRs are automatically hidden from `mine` results (consistent with `list` and `delegate`). Use `--pr`, `--pr-number`, or `--pr-numbers` to bypass this filter and view specific snoozed PRs.

## Examples

```bash
# List your open PRs
prctrl mine

# Show all PRs at once (non-interactive)
prctrl mine --all

# Show your PRs with priority scores
prctrl mine --priority

# Get JSON output for scripting
prctrl mine --json

# Include draft PRs
prctrl mine -d

# Only show PRs from the last 7 days
prctrl mine --since-days 7

# Filter by repository
prctrl mine --repo my-repo

# Filter by author
prctrl mine --author johndoe

# Target a specific PR (bypasses snooze filter)
prctrl mine --pr 123

# Target multiple specific PRs
prctrl mine --pr-numbers 123,456,789

# Combine filters
prctrl mine --since-days 14 --repo api --priority

# Combine with global flags
prctrl mine --include-drafts --priority
```