pr-pilot

PullWise (published under the package name pullwise and the GitHub Action name pr-pilot) is a tool that automatically writes pull request descriptions, code reviews, and related development artifacts using OpenAI's GPT-4o model. The core idea is that most pull requests arrive with poor or missing descriptions, which makes code review harder and leaves the project history without useful context. This tool fills that gap without requiring developers to write anything manually.

The main way to use it is as a GitHub Action. You add a short workflow file to your repository, provide an OpenAI API key as a secret, and from that point on every new pull request gets a structured description automatically. The description includes a plain-English summary of what changed, a list of specific changes, a test plan, and suggested labels. The tool generates this by reading the full diff between the branch and its base, collecting the commit messages, and sending both to the AI model.

The same functionality is also available as a command-line tool installed via pip. Beyond generating PR descriptions, the CLI includes a long list of additional commands: getting a code review in the terminal, posting that review as a GitHub comment, generating changelog entries from commits, suggesting reviewers based on who last edited the changed files, summarizing recent commits as a standup update, scanning for TODO and FIXME comments and turning them into GitHub issues, generating docstrings for changed functions, writing unit tests for a file or function, scanning diffs for security issues, suggesting branch names from a plain-English task description, and more.

The cost per pull request description is around one to three cents using GPT-4o, which the README estimates works out to roughly one to three dollars per month for a small team. The tool only sends the diff and commit messages to OpenAI; no other repository data leaves the CI runner.

It requires an OpenAI API key and works with repositories in any programming language.