{"_id":"pullfrog","_rev":"88-cb15509c646428dbdea0436d90e67834","name":"pullfrog","dist-tags":{"beta":"0.0.195-beta.7","latest":"0.1.68"},"versions":{"0.0.1":{"name":"pullfrog","version":"0.0.1","_id":"pullfrog@0.0.1","maintainers":[{"name":"colinhacks","email":"colinmcd94@gmail.com"}],"dist":{"shasum":"9e8ef95d021a55e2b107a49fb69fecdc318f86a6","tarball":"https://registry.npmjs.org/pullfrog/-/pullfrog-0.0.1.tgz","fileCount":3,"integrity":"sha512-mPQ0YlGavdD6dZMN5N12ge8mG3/VPzFnCeYL692jamuG34ZcqglJitwnqJnvYXv6J/8zltX52aVTnuaC+W4uvA==","signatures":[{"sig":"MEYCIQDeOpVymeyP5DzkWDmZcJ8Y7LMDf//VDiLrpegw5Pjw6wIhAJPJxCbSUGVAMYMtDxHZDfpnd9wmmDJG54XpqA1c0F9G","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":620},"main":"./index.js","types":"./index.d.ts","module":"./index.js","exports":{".":{"main":"./index.js","types":"./index.d.ts","module":"./index.js","exports":"./index.js"}},"gitHead":"d5c048a193502763e95bfc61cb806b2727338dea","scripts":{"gh-check":"tsx --env-file=.env ghCheck.mts"},"_npmUser":{"name":"colinhacks","email":"colinmcd94@gmail.com"},"_npmVersion":"11.4.2","directories":{},"_nodeVersion":"24.3.0","dependencies":{"npm-name":"^8.0.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/node":"^24.0.4","@biomejs/biome":"^1.9.4"},"_npmOperationalInternal":{"tmp":"tmp/pullfrog_0.0.1_1753994104649_0.35785865225427016","host":"s3://npm-registry-packages-npm-production"}},"0.0.195-beta.0":{"name":"pullfrog","version":"0.0.195-beta.0","keywords":["github-actions","ai-coding-agent","code-review"],"author":{"name":"Pullfrog","email":"support@pullfrog.com"},"license":"MIT","_id":"pullfrog@0.0.195-beta.0","maintainers":[{"name":"ssalbdivad","email":"david@arktype.io"},{"name":"colinhacks","email":"colinmcd94@gmail.com"}],"homepage":"https://github.com/pullfrog/pullfrog#readme","bugs":{"url":"https://github.com/pullfrog/pullfrog/issues"},"bin":{"pf":"dist/cli.mjs","pullfrog":"dist/cli.mjs","pullfrog-dev":"dist/cli.mjs"},"dist":{"shasum":"fc3dbdc99010d73717839bfb53bffbc0a3db2e66","tarball":"https://registry.npmjs.org/pullfrog/-/pullfrog-0.0.195-beta.0.tgz","fileCount":8,"integrity":"sha512-vfl4XYuTc9aRSFqNdm0WOUVwLQ0vtdlqr0QvE+CXnexcJ5VjPU2QycQ6NSduZKVRVvfNJt518WD7c8V/deEXUA==","signatures":[{"sig":"MEUCIQDO65DIOQte3ktpP2xV9xSqg0OeIv0znmU3KdEsJSq0gQIgQ4NmXfCXcanqj+120dnbe1vsQw0gPJtKrRGY7s8BBvE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6079209},"main":"./dist/index.js","type":"module","zshy":{"exports":"./index.ts"},"types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.cts","import":"./dist/index.js","require":"./dist/index.cjs","@pullfrog/source":"./index.ts"},"./internal":{"types":"./dist/internal.d.cts","import":"./dist/internal.js","default":"./dist/internal.js","@pullfrog/source":"./internal/index.ts"},"./package.json":"./package.json"},"gitHead":"584f17ce98cd09fd3eae0062358b722c2ab9780f","scripts":{"lock":"pnpm install --no-frozen-lockfile","play":"node play.ts","test":"vitest","build":"node esbuild.config.js","upDeps":"pnpm up --latest","prepare":"cd .. && husky action/.husky","runtest":"node test/run.ts","scratch":"node scratch.ts","typecheck":"tsc --noEmit","postinstall":"node scripts/generate-proxies.ts","check:entrypoints":"node scripts/check-entrypoint-imports.ts"},"_npmUser":{"name":"colinhacks","email":"colinmcd94@gmail.com"},"repository":{"url":"git+https://github.com/pullfrog/pullfrog.git","type":"git"},"_npmVersion":"11.4.2","description":"

\"Green","directories":{},"maintainers":[{"name":"ssalbdivad","email":"david@arktype.io"},{"name":"colinhacks","email":"colinmcd94@gmail.com"}],"_nodeVersion":"24.19.0","_hasShrinkwrap":false,"packageManager":"pnpm@10.27.0+sha512.72d699da16b1179c14ba9e64dc71c9a40988cbdc65c264cb0e489db7de917f20dcf4d64d8723625f2969ba52d4b7e2a1170682d9ac2a5dcaeaab732b7e16f04a","devDependencies":{"ajv":"^8.18.0","arg":"^5.0.2","yaml":"^2.8.2","execa":"^9.6.0","husky":"^9.0.0","table":"^6.9.0","dotenv":"^17.2.3","semver":"^7.7.3","skills":"1.4.9","undici":"^7.22.0","vitest":"^4.0.17","@ark/fs":"0.56.0","arktype":"2.2.0","esbuild":"^0.25.9","fastmcp":"^3.34.0","arkregex":"0.0.5","turndown":"^7.2.0","@ark/util":"0.56.0","file-type":"^21.3.0","lru-cache":"^11.0.0","picocolors":"^1.1.1","typescript":"^5.9.3","@types/node":"^24.7.2","object-hash":"^3.0.0","opencode-ai":"1.18.5","@actions/core":"^1.11.1","@octokit/rest":"^22.0.0","@openai/codex":"0.147.0","@types/semver":"^7.7.1","agent-browser":"0.25.4","@clack/prompts":"^1.2.0","@types/turndown":"^5.0.5","@opencode-ai/sdk":"1.18.5","@openai/codex-sdk":"0.147.0","@toon-format/toon":"^1.0.0","@types/object-hash":"^3.0.6","@standard-schema/spec":"1.1.0","@octokit/webhooks-types":"^7.6.1","package-manager-detector":"^1.6.0","@anthropic-ai/claude-code":"2.1.150","@modelcontextprotocol/sdk":"^1.26.0","@octokit/plugin-throttling":"^11.0.3"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pullfrog_0.1.68_1788478199159_0.7215088940510308"}}},"time":{"created":"2025-07-31T20:35:04.648Z","modified":"2026-09-03T23:29:59.676Z","0.0.1":"2025-07-31T20:35:04.848Z","0.0.195-beta.0":"2026-04-12T17:01:22.542Z","0.0.195-beta.1":"2026-04-12T17:34:32.357Z","0.0.195-beta.2":"2026-04-12T17:42:45.465Z","0.0.195-beta.3":"2026-04-12T17:47:26.007Z","0.0.195-beta.4":"2026-04-12T17:49:49.162Z","0.0.195-beta.5":"2026-04-12T17:58:31.904Z","0.0.195-beta.6":"2026-04-12T18:23:09.052Z","0.0.195-beta.7":"2026-04-12T18:30:28.240Z","0.0.196":"2026-04-12T19:03:08.468Z","0.0.197":"2026-04-12T19:17:44.457Z","0.0.198":"2026-04-12T19:51:54.315Z","0.0.199":"2026-04-14T23:35:38.414Z","0.0.200":"2026-04-14T23:58:07.645Z","0.0.201":"2026-04-15T20:27:23.890Z","0.0.202":"2026-05-01T16:00:25.588Z","0.0.203":"2026-05-05T17:13:29.772Z","0.0.204":"2026-05-06T01:51:45.244Z","0.0.205":"2026-05-08T19:30:22.383Z","0.1.0":"2026-05-08T21:27:41.811Z","0.1.1":"2026-05-08T21:32:46.203Z","0.1.2":"2026-05-08T23:38:26.913Z","0.1.3":"2026-05-11T23:07:17.728Z","0.1.4":"2026-05-11T23:23:24.950Z","0.1.5":"2026-05-13T04:56:41.399Z","0.1.6":"2026-05-13T18:24:39.270Z","0.1.7":"2026-05-14T02:49:13.417Z","0.1.8":"2026-05-14T05:38:12.970Z","0.1.9":"2026-05-20T14:10:41.705Z","0.1.10":"2026-05-20T15:02:13.242Z","0.1.11":"2026-05-20T16:50:22.046Z","0.1.12":"2026-05-23T08:42:42.562Z","0.1.13":"2026-05-23T16:37:13.680Z","0.1.14":"2026-05-26T18:32:26.436Z","0.1.15":"2026-06-01T18:45:20.774Z","0.1.16":"2026-06-02T04:18:11.017Z","0.1.17":"2026-06-02T15:46:01.623Z","0.1.18":"2026-06-02T18:26:04.664Z","0.1.19":"2026-06-04T14:13:34.502Z","0.1.20":"2026-06-04T16:34:51.391Z","0.1.21":"2026-06-04T16:39:05.120Z","0.1.22":"2026-06-04T19:07:30.674Z","0.1.23":"2026-06-05T05:16:28.401Z","0.1.24":"2026-06-05T18:42:06.364Z","0.1.25":"2026-06-08T21:32:58.284Z","0.1.26":"2026-06-08T21:34:00.601Z","0.1.27":"2026-06-08T21:52:41.319Z","0.1.28":"2026-06-08T22:17:20.275Z","0.1.29":"2026-06-08T22:30:39.947Z","0.1.30":"2026-06-12T16:20:11.796Z","0.1.31":"2026-06-24T22:08:59.045Z","0.1.32":"2026-07-02T00:30:19.530Z","0.1.33":"2026-07-07T14:13:24.681Z","0.1.34":"2026-07-09T18:56:46.239Z","0.1.35":"2026-07-12T21:48:16.505Z","0.1.36":"2026-07-15T00:59:29.793Z","0.1.37":"2026-07-21T15:11:24.308Z","0.1.38":"2026-07-21T20:21:59.895Z","0.1.39":"2026-07-23T05:15:14.361Z","0.1.40":"2026-07-26T19:28:45.685Z","0.1.41":"2026-07-28T22:05:25.833Z","0.1.42":"2026-07-29T00:33:01.166Z","0.1.43":"2026-07-29T18:34:00.265Z","0.1.44":"2026-07-30T01:05:20.185Z","0.1.45":"2026-07-30T03:36:01.355Z","0.1.46":"2026-07-31T22:41:25.484Z","0.1.47":"2026-08-02T00:54:37.176Z","0.1.48":"2026-08-02T08:08:04.649Z","0.1.49":"2026-08-02T16:58:39.396Z","0.1.50":"2026-08-03T19:00:23.733Z","0.1.51":"2026-08-03T20:01:28.320Z","0.1.52":"2026-08-04T07:13:04.835Z","0.1.53":"2026-08-05T17:47:09.862Z","0.1.54":"2026-08-13T22:42:20.903Z","0.1.55":"2026-08-13T22:55:14.595Z","0.1.56":"2026-08-14T01:01:05.236Z","0.1.57":"2026-08-15T01:27:10.700Z","0.1.59":"2026-08-17T19:19:54.548Z","0.1.60":"2026-08-17T19:33:56.779Z","0.1.61":"2026-08-25T01:43:22.812Z","0.1.62":"2026-08-25T02:12:55.819Z","0.1.63":"2026-08-25T17:05:45.752Z","0.1.64":"2026-08-25T19:11:07.205Z","0.1.65":"2026-08-28T23:13:17.147Z","0.1.66":"2026-09-01T05:40:07.991Z","0.1.67":"2026-09-02T00:32:50.349Z","0.1.68":"2026-09-03T23:29:59.330Z"},"bugs":{"url":"https://github.com/pullfrog/pullfrog/issues"},"author":{"name":"Pullfrog","email":"support@pullfrog.com"},"license":"MIT","homepage":"https://github.com/pullfrog/pullfrog#readme","keywords":["github-actions","ai-coding-agent","code-review"],"repository":{"url":"git+https://github.com/pullfrog/pullfrog.git","type":"git"},"description":"<p

\"Green","maintainers":[{"name":"ssalbdivad","email":"david@arktype.io"},{"name":"colinhacks","email":"colinmcd94@gmail.com"}],"readme":"<p\n

\n \n \n \"Green\n
\n Pullfrog\n

\n

\n The BYOK CodeRabbit that runs in your GitHub Actions\n

\n

\n\n

\n pullfrog.com · Docs · Console · Discord\n

\n\n
\n\n> **New** — Pullfrog is now [free for personal and open-source usage](https://pullfrog.com/blog/free-for-open-source).\n\n## What is Pullfrog?\n\nPullfrog is the BYOK CodeRabbit that runs in your GitHub Actions. It listens for GitHub events — PRs opened, issues created, reviews submitted, CI failures — and triggers agent runs based on your configuration, via a `pullfrog.yml` workflow that uses this open-source action. You control the infrastructure, the keys, and the costs.\n\nPullfrog is not an agent itself. It wraps vanilla **[Claude Code](https://github.com/anthropics/claude-code)**, **[Codex](https://github.com/openai/codex)**, and **[OpenCode](https://github.com/anomalyco/opencode)**, selecting the one that matches your BYOK or bring-your-own-subscription configuration — so every run uses the vendor's real agent, and it reads the repo-level config you already keep for it: `CLAUDE.md` or `AGENTS.md`, skills, custom commands, and repo-level MCP servers.\n\nOut of the box, it can:\n\n- **Review new PRs** — auto-review every incoming PR; the review verdict can gate merges via requireable status checks.\n- **Address reviews** — leave review comments on a Pullfrog PR as you would for a human colleague, and it addresses them.\n- **Autofix CI** — Pullfrog detects CI failures on its own PRs and attempts a fix. It can be configured to fix human PRs too.\n- **Autofix merge conflicts** — keep PRs mergeable without hand-resolving.\n- **Triage issues** — respond to common questions, apply labels, link related issues and PRs, or draft implementation plans.\n- **Anything ad hoc** — tag `@pullfrog` in any issue, PR, or comment. It pulls in the surrounding context and figures out what to do. Prompt from the [console](https://pullfrog.com/console) for anything else.\n\nEach automation can be toggled from the dashboard and customized with per-trigger instructions.\n\n## Get started\n\nRun one command in any local repo:\n\n```sh\nnpx pullfrog init\n```\n\nOr [install from the browser](https://pullfrog.com/console). Setup takes about two minutes: install the GitHub App, add the `pullfrog.yml` workflow with one click, and pick a model. See [getting started](https://docs.pullfrog.com/getting-started).\n\n## Runs on the subscription you already pay for\n\nNo API key required. Connect a coding-agent plan once and every run bills against it:\n\n| Plan | Connect with |\n| --- | --- |\n| [Claude Pro/Max](https://docs.pullfrog.com/claude-auth) | `npx pullfrog auth claude` |\n| [ChatGPT Codex](https://docs.pullfrog.com/codex-auth) | `npx pullfrog auth codex` |\n| [Grok](https://docs.pullfrog.com/grok-auth) | `npx pullfrog auth grok` |\n| [Kimi Code](https://docs.pullfrog.com/kimi-code) | a Kimi Code key as `KIMI_API_KEY` |\n| [OpenCode Go](https://docs.pullfrog.com/models#opencode-zen-and-opencode-go) | an OpenCode key as `OPENCODE_API_KEY` |\n\n## Or bring your own model\n\nPullfrog works with any LLM provider: Anthropic, OpenAI, Google, xAI, Mistral, DeepSeek, OpenRouter, and more. Switch models with a config change. Two more ways to pay for tokens:\n\n- **Your own API key** — stored in Pullfrog's encrypted secret store or in GitHub Actions secrets, your choice.\n- **Router** — Pullfrog's built-in model access, billed at raw provider cost with no markup.\n\n## Batteries included\n\n- 🛠️ **MCP tools for GitHub** — a purpose-built MCP server for git and GitHub operations: creating PRs, leaving reviews and comments, reading CI logs, managing issues. Every operation goes through Pullfrog's permission layer.\n- 🛡️ **Secure shell access** — shell commands run in an isolated subprocess without access to sensitive environment variables.\n- 🌐 **Headless browser** — for end-to-end tests, screenshots, and UI iteration, with screenshot uploads out of the box.\n- 🔑 **Short-lived credentials** — all GitHub operations use an installation token that is auto-revoked when the run completes. Keys are auto-masked in logs, and only the minimum necessary environment variables pass through to the agent.\n- 🪝 **Hooks** — setup, post-checkout, pre-push, and stop scripts that run inside the agent's permission boundary. A stop script that exits non-zero resumes the agent with the failure as context, so it fixes its own broken push instead of opening a red PR.\n- 🔐 **GitHub-native permissions** — GitHub remains the single source of truth for access control. Users only see repos they already have access to; org settings require an org owner.\n\n## Pricing\n\nPullfrog is free for developers on personal GitHub accounts and free for open-source repos. Pro is $30/month for the whole organization with no per-run or per-seat billing — required for an org's private repos, optional everywhere else. Pullfrog also covers model cost for impactful open-source projects — [apply here](https://pullfrog.com/for-oss).\n\n## Standalone usage\n\nThe same `pullfrog/pullfrog@v0` action that powers the automations above also works as a step in your own workflows — an agent as one stage of a larger pipeline. The action takes a `prompt` and the provider key of your choice; the only permission it needs is `id-token: write`, which lets it mint its own short-lived GitHub token.\n\n```yaml\n# .github/workflows/agent.yml — run any prompt on demand\nname: Agent\non:\n workflow_dispatch:\n inputs:\n prompt:\n description: What should the agent do?\n required: true\n\njobs:\n agent:\n runs-on: ubuntu-latest\n permissions:\n id-token: write\n contents: read\n steps:\n - uses: actions/checkout@v4\n - uses: pullfrog/pullfrog@v0\n with:\n prompt: ${{ inputs.prompt }}\n env:\n ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}\n```\n\nThe action also exposes a `result` output that subsequent steps can consume. See [CI integration](https://docs.pullfrog.com/headless-action) for the full guide.\n\n
\nExample: auto-generate release notes on new tags\n\n```yaml\nname: Release\non:\n push:\n tags: ['v*']\n\npermissions:\n contents: write\n\njobs:\n release:\n runs-on: ubuntu-latest\n steps:\n - name: Checkout\n uses: actions/checkout@v4\n with:\n fetch-depth: 0\n\n - name: Generate release notes\n id: notes\n uses: pullfrog/pullfrog@v0\n with:\n prompt: |\n Generate release notes for ${{ github.ref_name }}.\n Compare commits between this tag and the previous tag.\n Format as markdown: summary paragraph, then ### Features, ### Fixes, ### Breaking Changes sections.\n Omit empty sections. Be concise.\n env:\n ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}\n\n # write to file to avoid shell escaping issues with special characters\n - name: Create GitHub release\n run: |\n notesfile=\"$RUNNER_TEMP/release-notes-$GITHUB_RUN_ID.md\"\n printf '%s' \"$NOTES\" > \"$notesfile\"\n gh release create ${{ github.ref_name }} --title \"${{ github.ref_name }}\" --notes-file \"$notesfile\"\n env:\n GH_TOKEN: ${{ github.token }}\n NOTES: ${{ steps.notes.outputs.result }}\n```\n\n
\n\n
\nExample: prompt from a file\n\nFor longer prompts you want to version and reuse, commit the prompt text to the repo and pass its path with `prompt_file` instead of inlining it. The path is resolved relative to `GITHUB_WORKSPACE`, and it is mutually exclusive with `prompt` — set exactly one.\n\n```yaml\n# .github/workflows/triage.yml\n- uses: actions/checkout@v4\n- uses: pullfrog/pullfrog@v0\n with:\n prompt_file: .github/pullfrog/triage.md\n env:\n ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}\n```\n\n
\n\n
\nStructured output\n\nPass a JSON Schema via the `output_schema` input to make the agent's output required and validated — the bridge between an agent's reasoning and the hard steps that follow it. See [capturing agent output](https://docs.pullfrog.com/headless-action#capturing-agent-output) for the details and a worked example.\n\n
\n","readmeFilename":"README.md"}