Getting started

A repository needs two things to run Pullfrog: the Pullfrog GitHub App and a .github/workflows/pullfrog.yml workflow. The console sets up both.

Sign in

Sign in to the Pullfrog console with your GitHub account.

Install the GitHub App

Install the app on your personal account or an organization, with access to every repository or only the ones you pick. Installing it turns nothing on: Pullfrog acts on a repository only once it has the workflow file.

Choose how to pay for models

The console asks for a billing mode. On an organization, an org owner makes this choice.

  • Bring your own key: a provider API key or an existing subscription, billed by your provider. The console then asks for the provider, its credentials, and a model.
  • Pullfrog Router: every model through Pullfrog's gateway, paid from a balance at provider cost with no markup. By default, Pullfrog picks the model for each run.

You can switch later under Providers in the console's Billing section.

Add the workflow

Click Install next to each repository. The console commits .github/workflows/pullfrog.yml to the default branch.

  • When branch protection or a repository ruleset blocks the commit, the console opens a PR instead, and Pullfrog turns on once it merges.
  • To set up a repository later, open it in the console and click Add workflow directly or Add workflow via PR.

Send a test prompt

Open the repository in the console, type a prompt such as "Summarize what this repository does", and press Cmd+Enter (Ctrl+Enter on Windows and Linux). Pullfrog dispatches a GitHub Actions run and opens its logs in a new tab.

Manual workflow setup

To add the workflow yourself, create .github/workflows/pullfrog.yml (or pullfrog.yaml) on the default branch. Then click Verify manual installation on the repository's console page.

.github/workflows/pullfrog.yml
# PULLFROG ACTION — DO NOT EDIT EXCEPT WHERE INDICATED
name: Pullfrog
run-name: ${{ inputs.name || github.workflow }}
on:
  workflow_dispatch:
    inputs:
      prompt:
        type: string
        description: Agent prompt
      name:
        type: string
        description: Run name

permissions:
  contents: read

jobs:
  pullfrog:
    runs-on: ubuntu-latest
    permissions:
      id-token: write
      contents: read
    steps:
      - name: Checkout code
        uses: actions/checkout@v6
        with:
          fetch-depth: 1
          persist-credentials: false
      - name: Run agent
        uses: pullfrog/pullfrog@v0
        with:
          prompt: ${{ inputs.prompt }}

The console's version adds an env: block that maps provider keys from GitHub Actions secrets. Add one only if you keep keys there. Pullfrog Router and keys stored in Pullfrog need no workflow changes.

Uninstalling

Uninstalling the GitHub App stops every run on that account.

  1. Open the installed GitHub Apps for your personal account, or https://github.com/organizations/<org>/settings/installations for an organization.
  2. Click Configure next to Pullfrog.
  3. Click Uninstall at the bottom of the page.

The workflow does nothing without the app, so deleting pullfrog.yml is optional. To delete your Pullfrog account and its data, email support@pullfrog.com.

© 2026 Pullfrog, Inc.

On this page