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

assign

Assign yourself as a reviewer on a PR.

Skip the web UI — claim review responsibility directly from the terminal.

When to Use

  • Quick claim: “I want to review this before anyone else”
  • Triage workflow: Pair with delegate for AI-assisted assignment
  • Scripting: Use --json for programmatic integrations
  • Batch operation: Use --all to assign to all pending reviews at once

Synopsis

prctrl assign [OPTIONS] [PR_NUMBER]

Options

FlagDescriptionDefault
PR_NUMBERPR number to assign yourself to (shorthand for --pr)Required if no --pr
-p, --prGlobal flag: target a specific PR number-
-a, --allAssign yourself to all pending reviews at oncefalse
-n, --pr-numbersPR number(s) to assign (comma-separated, e.g. 123,456)-
-s, --since-daysOnly show PRs created since this many days ago-
-n, --dry-runPreview what would be assigned without actually assigningfalse
--jsonOutput as JSON for scriptingfalse
-q, --quietSuppress per-PR progress messages (show only summary)false
--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

# Assign to a specific PR
prctrl assign 4821

# Preview what would be assigned (dry-run)
prctrl assign --all --dry-run

# Assign using global --pr flag
prctrl --pr 4821 assign

# Assign to all pending reviews at once
prctrl assign --all

# Assign to multiple specific PRs
prctrl assign --pr-numbers 4821,4822,4823

# Assign with JSON output (for scripting)
prctrl assign 4821 --json

# Assign to all PRs created in the last 3 days
prctrl assign --all --since-days 3

# Assign with priority scores shown (to pick highest priority PRs)
prctrl assign --priority

JSON Output

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

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

Tips

  • Use --all to quickly assign yourself to ALL pending reviews without prompting
  • Use --pr-numbers to assign to multiple specific PRs in one command
  • Use --dry-run to preview what would be assigned before making changes
  • Parallel requests are used when assigning to multiple PRs for speed