pr-list

name	pr-list
description	List pull requests from the repository. Use when the user wants to see open PRs, find PRs to review, check their own PRs, or browse PR history.
allowed-tools	Bash(aide:*)

List Pull Requests

List pull requests from the repository with filtering options.

When to Use

• User asks "what PRs are open?" or "show me the PRs"
• User wants to find PRs to review
• User wants to check their own open PRs
• User wants to browse completed/merged PRs

How to Execute

Run:

aide pr list [options]

Flags

Flag	Description
--status	Filter by status: active, completed, abandoned, all (default: active)
--limit	Maximum number of PRs to return (default: 20)
--created-by	Filter by creator email or display name
--author	Alias for --created-by
--project	Project name (auto-discovered from git remote)
--repo	Repository name (auto-discovered from git remote)
--format	Output format: text, json, markdown

Output Includes

1. PR number and title
2. Status (active, completed, abandoned)
3. Creation date
4. Author name
5. Description preview

Common Patterns

# List active PRs (default)
aide pr list

# List all PRs regardless of status
aide pr list --status all

# List completed (merged) PRs
aide pr list --status completed

# List your own PRs
aide pr list --created-by "[e-mail]"

# Combine filters
aide pr list --status active --created-by "john.doe" --limit 10

# Output as JSON for processing
aide pr list --format json

Use Cases

Goal	Command
Find PRs to review	aide pr list --status active
Track your work	aide pr list --created-by "[e-mail]"
Audit merged changes	aide pr list --status completed --limit 50
Monitor team activity	aide pr list --status all

Best Practices

• Use --status active (default) for day-to-day review work
• Use --created-by to quickly find your own PRs
• Use --format json when processing results programmatically
• Set --limit higher when searching for specific PRs

Next Steps

After listing PRs:

• Use pr-view skill to see details of a specific PR
• Use pr-comments skill to check feedback on a PR
• Use pr-diff skill to review code changes