pr-pilot-cli 1.5.0

CLI for PR Pilot, a text-to-task automation platform for Github.

Install | Documentation | Blog | Website

PR Pilot CLI

PR Pilot gives you a natural language interface for your Github projects. Given a prompt, it uses LLMs (Large Language Models) to autonomously fulfill tasks by interacting with your code base and Github issues.

Using Jinja templates, you can create powerful, reusable commands that can be executed by PR Pilot.

Usage

Open a terminal and ls into a repository you have installed PR Pilot.

Examples

You can run a prompt directly on the command line:

pilot -o README_German.md "translate the README into German"

Generate code quickly:

pilot -o test_utils.py --code "Write some unit tests for the utils.py file."

Get an organized view of your Github issues:

pilot "Find all open Github issues labeled as 'bug', categorize and prioritize them"

Get some advice on your code:

pilot "The 'TaskEngine' class is too complex. Read it and suggest refactoring options."

Generate parts of your README with a template:

pilot --direct -f prompts/README.md.jinja2 -o README.md

For more examples, check out the prompts directory in this repository.

Options and Parameters

You can change the default settings with parameters and options:

Usage: python -m cli.cli [OPTIONS] [PROMPT]...

Options:
  --wait / --no-wait        Wait for the result.
  --repo TEXT               Github repository in the format owner/repo.
  --spinner / --no-spinner  Display a loading indicator
  --quiet                   No pretty-print, no status indicator or messages.
  --cheap                   Use the cheapest GPT model (gpt-3.5-turbo)
  --code                    Optimize prompt and settings for generating code
  -f, --file PATH           Load prompt from a template file.
  --direct                  Do not feed the rendered template as a prompt into
                            PR Pilot, but render it directly as output.
  -o, --output PATH         Output file for the result.
  --model TEXT              GPT model to use.
  --debug                   Display debug information.
  --help                    Show this message and exit.

Installation

Prerequisites:

1. Install the PR Pilot app on your Github repository
2. Generate an API key in the dashboard

Install via pip:

pip install --upgrade pr-pilot-cli

Install via Homebrew:

brew tap PR-Pilot-AI/pr-pilot-homebrew
brew install pr-pilot-cli

Configuration

The configuration file is located at ~/.pr-pilot.yaml.

Contributing

Contributors are welcome to improve the CLI by submitting pull requests or reporting issues. For more details, check the project's GitHub repository.

License

The PR Pilot CLI is open-source software licensed under the GPL-3 license.