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

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

Or manually copy the prompt from [https://5.pullapprove.com/agent.md](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](/docs/cli) 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](/docs/cli) for installation instructions and command reference.