19 releases (3 stable)

1.1.0 Sep 14, 2023
0.9.5 Jun 29, 2023

#3 in #pull-requests

Download history 18/week @ 2023-06-04 43/week @ 2023-06-11 11/week @ 2023-06-18 153/week @ 2023-06-25 38/week @ 2023-07-02 11/week @ 2023-07-09 22/week @ 2023-07-16 18/week @ 2023-07-23 1/week @ 2023-07-30 78/week @ 2023-08-06 20/week @ 2023-08-13 1/week @ 2023-08-20 18/week @ 2023-08-27 26/week @ 2023-09-03 54/week @ 2023-09-10 9/week @ 2023-09-17

107 downloads per month

MIT license

517 lines


Generate GitHub PR descriptions from the command line with the help of AI. propr aims to populate a basic PR description right from your terminal so you can focus on more important things.



cargo install propr


Grab a binary from the releases page and move it into your desired bin (eg. /usr/local/bin) location.

mv propr-<os> /usr/local/bin/propr
chmod +x /usr/local/bin/propr


Generate your PRs from the command line with AI

Usage: propr <COMMAND>

  create    Creates a PR with a generated description
  generate  Generates a PR description and outputs it
  config    Configure propr to your liking
  help      Print this message or the help of the given subcommand(s)

  -h, --help     Print help
  -V, --version  Print version

Creating a PR

Creating a PR from the CLI is as easy as running propr create. If you want to specify which base branch to target you can provide the --branch flag. By default propr assumes that the main branch of the repository needs to be targeted.

Creates a PR with a generated description

Usage: propr create [OPTIONS]

  -b, --branch <branch>  The base branch to point your changes to
  -m, --model <model>    Instructs propr to use a specific model [possible values: gpt-3.5-turbo, gpt-3.5-turbo-16k, gpt-4, gpt-4-32k]
  -h, --help             Print help

You can regenerate a PR description at any time, even after the PR has already been created using propr generate.

Automatically generating a title

There is the option to allow propr to automatically generate a PR title based on the generated description. To enable this refer to propr config generate-title.


~1M SLoC