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

# 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:

/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

Output Format

## 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:

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