PR Poll - Automatic PR Review Notifications

จัดการ polling daemon ที่ตรวจสอบ PR reviews และส่ง notification อัตโนมัติ

Usage

/pr-poll              # Show status
/pr-poll start        # Start daemon (notification only)
/pr-poll auto         # Start daemon with auto-respond (Claude handles reviews)
/pr-poll stop         # Stop daemon
/pr-poll check        # Check once (no daemon)

Instructions

Step 1: Parse Command

ถ้าไม่มี argument หรือ status: → แสดงสถานะ daemon

ถ้า start: → Start daemon (notification only)

ถ้า auto: → Start daemon with auto-respond (Claude handles reviews automatically)

ถ้า stop: → Stop daemon

ถ้า check: → Run once and exit

Step 2: Execute Action

Status (default)

./scripts/pr-review-poll-status.sh

Output:

• Daemon status (running/stopped)
• Tracked PRs
• Last log entries

Start Daemon (Notification Only)

./scripts/pr-review-poll-start.sh --interval 300

Options:

• --interval N - Polling interval in seconds (default: 300 = 5 minutes)
• --repo OWNER/REPO - Specific repo to monitor

Output:

Daemon started (PID: 12345)

Log file: ~/.pr-review-poll.log
To view logs: tail -f ~/.pr-review-poll.log
To stop: ./pr-review-poll-stop.sh

Start Daemon with Auto-Respond

# Get current working directory
WORKING_DIR=$(pwd)

# Start with auto-respond enabled
./scripts/pr-review-poll-start.sh --interval 300 --auto-respond --working-dir "$WORKING_DIR"

Options:

• --auto-respond - Enable automatic Claude CLI spawning
• --working-dir DIR - Working directory for Claude (required with --auto-respond)

Output:

Daemon started (PID: 12345)
Auto-respond: ENABLED
Working dir: /path/to/repo

Log file: ~/.pr-review-poll.log
To view logs: tail -f ~/.pr-review-poll.log
To stop: ./pr-review-poll-stop.sh

How Auto-Respond Works:

1. Daemon detects new PR review
2. Spawns Claude CLI with /pr-review prompt
3. Claude analyzes and responds to review feedback
4. Log file created: ~/.pr-review-claude-{pr}-{timestamp}.log

Important Notes:

• Requires claude CLI to be installed and in PATH
• Uses --dangerously-skip-permissions for non-interactive execution
• Each Claude session runs in background with separate log file

Stop Daemon

./scripts/pr-review-poll-stop.sh

Output:

Daemon stopped

Check Once

./scripts/pr-review-poll.sh --once

Output:

• Lists checked PRs
• Sends notifications for new reviews

Step 3: Display Summary

## PR Poll Status

| Metric | Value |
|--------|-------|
| Status | Running / Stopped |
| PID | [pid] |
| Interval | [seconds]s |
| Tracked PRs | [count] |

### Recent Activity
[last 5 log lines]

### Commands
- Start: `/pr-poll start`
- Stop: `/pr-poll stop`
- Check now: `/pr-poll check`

How It Works

1. Polling: Daemon checks GitHub every N seconds for user's open PRs
2. Detection: Compares current reviews with stored state
3. Notification: Sends macOS notification for new reviews
4. Action: Notification suggests running /pr-review

Notification Types

| Review State | Sound | Message | |--------------|-------|---------| | APPROVED | Glass | "Approved by @reviewer" | | CHANGES_REQUESTED | Basso | "Changes requested by @reviewer" | | COMMENTED | Ping | "@reviewer left a comment" |

Files

| File | Purpose | |------|---------| | ~/.pr-review-poll.pid | Daemon PID file | | ~/.pr-review-poll.log | Daemon log file | | ~/.pr-review-state.json | PR review state |

Examples

# Start daemon with 5-minute interval (default, notification only)
/pr-poll start

# Start with auto-respond - Claude handles reviews automatically
/pr-poll auto

# Start with 1-minute interval for active development
./scripts/pr-review-poll-start.sh --interval 60

# Auto-respond with 1-minute interval
./scripts/pr-review-poll-start.sh --interval 60 --auto-respond --working-dir "$(pwd)"

# Monitor specific repo with auto-respond
./scripts/pr-review-poll-start.sh --repo owner/repo --auto-respond --working-dir /path/to/repo

# Quick check without starting daemon
/pr-poll check

Troubleshooting

| Issue | Solution | |-------|----------| | Daemon not starting | Check gh auth status | | No notifications | Check macOS notification settings | | Too many notifications | Increase poll interval | | Stale state | Delete ~/.pr-review-state.json |

Related Commands

| Command | Purpose | |---------|---------| | /pr-review | Handle PR review feedback | | /pr | Create PR | | /focus | Set current task |