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.
# 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.
- Open the installed GitHub Apps for your personal account, or
https://github.com/organizations/<org>/settings/installationsfor an organization. - Click Configure next to Pullfrog.
- 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.

