Fleet PR Agent#

Multi-repository pull request monitoring, triage, and summary tool for engineering teams and AI agent fleets managing many repos at once.

What It Does#

• Scans one or more GitHub repos for open PRs using the gh CLI
• Prioritizes by: staleness, review status, CI pass/fail, label priority
• Generates a structured Markdown triage report (no external dependencies — pure Python stdlib + gh)
• Supports concurrent scanning of multiple repos in a single run

Prerequisites#

• gh CLI authenticated ( gh auth status)
• Python 3.6+ (standard library only — no pip packages required)
• Repos accessible to your GitHub token

Quick Start#

bash

# Scan a single repo
python3 scripts/triage.py owner/repo

# Scan multiple repos
python3 scripts/triage.py owner/repo1 owner/repo2 owner/repo3

# Generate triage report to file
python3 scripts/triage.py owner/repo --output report.md

Usage as Claude Code Skill#

When invoked as /fleet-pr-agent, provide repos:

text

/fleet-pr-agent owner/repo1 owner/repo2

The agent will:

1. Fetch all open PRs from each repo via gh
2. Score and rank them by urgency (stale > failing CI > needs review > draft)
3. Output a prioritized Markdown summary

Triage Priority Rules#

PriorityConditionP0 - CriticalCI failing + older than 3 daysP1 - HighApproved but not merged, or review requested > 2 days agoP2 - MediumOpen > 5 days, no review activityP3 - LowDraft PRs, recently opened

Output Format#

markdown

## PR Triage Report — 2026-03-27

### P0 — Critical (2)
- [#123 Fix auth middleware](url) — CI failing since Mar 24, 2 approvals
- [#456 DB migration](url) — CI failing since Mar 25, no reviews

### P1 — High (1)
- [#789 Add caching layer](url) — Approved Mar 25, ready to merge

### P2 — Medium (3)
...

### Summary
- Total open PRs: 15
- Needing attention: 6
- Repos scanned: 2

Configuration#

Set env vars to override defaults:

VariableDefaultDescriptionFLEET_PR_STALE_DAYS``5Days before a PR is considered staleFLEET_PR_CI_WEIGHT``3Weight multiplier for CI-failing PRsFLEET_PR_MAX_PRS``50Max PRs to fetch per repo

Architecture#

• scripts/triage.py — Pure Python 3 triage engine (stdlib only)
• No external package dependencies
• Uses gh pr list --json for all data fetching
• Portable across Linux, macOS, Windows (Python + gh required)

License#

MIT