Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

comment

Post a comment on a PR directly from the CLI.

Share feedback, ask questions, or leave notes — all without leaving your terminal.

When to Use

  • Leave feedback: “Minor nit, consider fixing”
  • Ask questions: “Can you explain this?”
  • Document decisions: “Approved with this note”
  • Batch comment: Use --all to post the same comment to all pending reviews

Synopsis

prctrl comment [OPTIONS] [PR_NUMBER]

Options

FlagDescriptionDefault
PR_NUMBERPR number to comment onRequired if no --pr
-t, --text <TEXT>Comment text (supports markdown)Required
-a, --allPost comment to all pending reviews at oncefalse
--pr-numbersPR number(s) to comment on (comma-separated, e.g. 123,456)-
-p, --prGlobal flag: target a specific PR number-
-n, --dry-runPreview what would be commented without actually postingfalse
--jsonOutput as JSON (useful for scripting)
-q, --quietSuppress per-PR progress messages (show only summary)false
-s, --since-daysOnly show PRs created since this many days ago-
--repoFilter by repository name (partial match, case-insensitive)-
--authorFilter by author username (partial match, case-insensitive)-
-P, --priorityShow priority scores for each PR (1-5 stars based on age and size)false

Examples

# Comment on a specific PR
prctrl comment 4821 --text "Looks good, just a few nits"

# Preview what would be commented (dry-run)
prctrl comment --all --text "Please address feedback" --dry-run

# Comment on all pending reviews at once
prctrl comment --all --text "Please address feedback before merging"

# Comment on multiple specific PRs
prctrl comment --pr-numbers 4821,4822 --text "LGTM!"

# Comment on recent PRs only (last 7 days)
prctrl comment --all --since-days 7 --text "Great work!"

# Comment with priority scores shown (to pick which PRs to comment on)
prctrl comment --priority --text "Please review"

Tips

  • Use --all to quickly post the same comment to ALL pending reviews at once
  • Use --pr-numbers to comment on multiple specific PRs in one command
  • Use --dry-run to preview what would be commented before posting
  • Parallel requests are used when commenting on multiple PRs for speed
  • If no PR number is provided and --all is not used, shows your pending reviews and lets you select interactively