Agents

PullApprove provides an AI agent prompt that helps you configure, migrate, and fix PullApprove configurations automatically. The agent works with any coding assistant (Claude, Cursor, GitHub Copilot, etc.) and runs entirely on your local machine.

Quick Start

The easiest way to get started is to use this one-liner with your coding assistant:

claude "$(curl -LsSf https://5.pullapprove.com/agent.md)"

Or manually copy the prompt from https://5.pullapprove.com/agent.md and paste it into your preferred AI assistant.

What It Does

When you run the agent prompt, it:

1. Installs the PullApprove CLI locally using uv if not already available
2. Analyzes your repository to determine the current state (existing configs, migrations needed, etc.)
3. Provides intelligent assistance for configuration tasks using the CLI tools
4. Validates all changes using pullapprove check and other verification commands

The agent has access to validation and configuration tools like:

• pullapprove check - validate configuration syntax
• pullapprove match - test file path matching
• pullapprove coverage - verify review coverage
• And more (see CLI docs for full reference)

Pre-Configured Use Cases

• Fix Configuration Errors - Repair broken CODEREVIEW.toml files
• Migrate from PullApprove v3 - Convert .pullapprove.yml to v5 format
• Migrate from CODEOWNERS - Transform GitHub CODEOWNERS to PullApprove scopes
• Create New Configurations - Set up PullApprove from scratch

Manual Alternative

If you prefer to work with the CLI directly, see the CLI documentation for installation instructions and command reference.