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
- PR number and title
- Status (active, completed, abandoned)
- Creation date
- Author name
- 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 "your.email@company.com"
# 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 "me@company.com" |
| 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-byto quickly find your own PRs - Use
--format jsonwhen processing results programmatically - Set
--limithigher 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