> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pullfrog.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Pullfrog runs coding agents inside your GitHub repositories to review pull requests, plan issues, and write code.

Pullfrog puts a coding agent to work in your GitHub repositories. It reviews pull requests, plans and triages issues, and writes code when you mention `@pullfrog` in a comment.

## How it works

* **The Pullfrog GitHub App** listens to your repository's events, checks who triggered each one, and decides when to start a run.
* **A `pullfrog.yml` workflow** in `.github/workflows/` runs the agent on your own GitHub Actions runners, against a checkout of your repository.
* **The [console](https://pullfrog.com/console)** holds each repository's settings: the model, which events trigger a run, and your review and coding instructions.

Runs start from an `@pullfrog` mention on an issue or PR, from the prompt box in the console, or automatically: on a new PR, a new issue, a review on a Pullfrog PR, or a failing CI check.

## What you get

* **Any model.** Pay through [Pullfrog Router](/billing#pullfrog-router) at provider cost with no markup, bring your own API key, or use a Claude, ChatGPT, Grok, Kimi Code, or OpenCode Go subscription you already have. Some models are free.
* **Agent-agnostic.** Pullfrog runs Claude Code for Anthropic models and OpenCode for every other provider, with an experimental Codex harness. See [model resolution](/models#model-resolution).
* **Scoped credentials.** Each run gets repository-scoped GitHub tokens that Pullfrog revokes when the run ends. Provider keys are stored encrypted in Pullfrog or in your GitHub Actions secrets.
* **Free for individuals and open source.** Personal accounts and public repositories run free. Organizations need a plan for private repositories, after a 14-day trial. See [Billing](/billing).
* **An open-source action.** The [Pullfrog GitHub Action](https://github.com/pullfrog/pullfrog) is MIT-licensed.

## Explore the docs

<CardGroup cols={2}>
  <Card title="Getting started" icon="rocket" href="/getting-started">
    Install the GitHub App, add the workflow, and send your first prompt.
  </Card>

  <Card title="PR reviews" icon="magnifying-glass" href="/pr-reviews">
    Automatic reviews on new PRs and new commits, and fixes for the comments they leave.
  </Card>

  <Card title="Issues" icon="circle-dot" href="/issue-enrichment">
    Duplicate checks, related issues, and implementation plans on new issues.
  </Card>

  <Card title="Coding tasks" icon="code" href="/coding-tasks">
    Pullfrog addresses reviews and fixes failing CI on its own PRs.
  </Card>

  <Card title="Model access" icon="key" href="/model-access">
    Free models, Pullfrog Router, your own API key, or an existing subscription.
  </Card>

  <Card title="Security" icon="shield-halved" href="/security">
    Sandboxing, secret isolation, and short-lived GitHub tokens.
  </Card>

  <Card title="CLI configuration" icon="terminal" href="/cli-configuration">
    Inspect and change settings and stored credentials from the terminal.
  </Card>

  <Card title="Comparisons" icon="scale-balanced" href="/comparisons">
    How Pullfrog compares to vendor agent actions and GitHub Copilot.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.