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

# monitor

**Watch for new PRs and get notified — runs in the background.**

Perfect for developers who want to know immediately when their attention is needed, without constantly checking manually.

## When to Use

- You want instant notifications for new PRs
- You're in a flow state and don't want to switch contexts
- You need to catch PRs that request your review ASAP

## Synopsis

```bash
prctrl monitor [OPTIONS]
```

## Options

| Flag | Description | Default |
|------|-------------|---------|
| `-i, --interval <SECONDS>` | How often to check GitHub | `300` (5 min) |
| `--notify` | Send macOS notifications for new PRs | `false` |
| `--auto-open` | Auto-open PR in Chrome when notified | `false` |
| `--no-auto-open` | Disable auto-opening (use with `--notify`) | `false` |
| `--interactive` | Prompt for action on each new PR | `false` |

**Note:** `--notify` and `--auto-open` are disabled by default. Use `--notify` to enable notifications, and `--auto-open` (or `--notify --auto-open`) to also open PRs automatically.

## Examples

```bash
# Start monitoring with defaults (checks every 5 minutes, no notifications)
prctrl monitor

# Check more frequently (every minute)
prctrl monitor --interval 60

# Enable notifications (no auto-open)
prctrl monitor --notify

# Enable notifications AND auto-open in Chrome
prctrl monitor --notify --auto-open

# Notifications only, no auto-open (good for meetings)
prctrl monitor --notify --no-auto-open

# Interactive mode - choose what to do for each new PR
prctrl monitor --notify --interactive

# Run in background (add & to detach)
prctrl monitor &
```

## Interactive Mode Actions

When `--interactive` is enabled, each new PR shows:

```
🔔 New PR: feat: add dark mode #4821

🎯 What to do?
  [d] Delegate to Claude
  [o] Open in browser
  [a] Assign myself
  [s] Snooze (hide for 3 days)
  [q] Quit monitoring
```

## Background Operation

```bash
# Start and detach
prctrl monitor &

# Check if running
prctrl monitor-status

# Stop monitoring
prctrl monitor-stop
```

## Tips

- Use `--interval 60` during code freeze/release when PRs pile up
- Combine with `--no-auto-open` when you need to context-switch carefully
- The monitor process survives terminal restarts (uses a PID file)